NeXTSTEPDRIVERKIT:Chapter5 Functions

Functions

함수

This section describes three types of functions and macros:
이 절에서는 세 가지 유형의 함수 및 매크로에 대해 설명합니다.

• General-purpose functions--to perform basic tasks
  범용 함수--기본 작업 수행
• Driver Debugging Module (DDM) functions--to help all drivers keep debugging information
  드라이버 디버깅 모듈 (DDM) 함수--모든 드라이버가 디버깅 정보를 유지할 수 있도록 지원
• Miscellaneous functions--such as DMA alignment macros, functions that work only in the kernel, and functions specific to a particular machine architecture.
  기타 함수--DMA 정렬 매크로, 커널에서만 작동하는 기능 및 특정 시스템 아키텍처와 관련된 함수 등이 있습니다.

Unless noted otherwise, all of the functions described in this section work in both user-level and kernel-level drivers.
별도로 언급하지 않는한, 이 절에서 설명하는 모든 함수는 사용자 수준 및 커널 수준의 드라이버에서 모두 작동합니다.

드라이버가 사용할 수 있는 기타 함수

Almost all Mach functions are available to kernel-level device drivers. If you don't find the appropriate functionality in a method or function, you can use a Mach function. For example, port_allocate() and msg_send() are used by many drivers.
거의 모든 Mach 함수는 커널 수준 장치 드라이버에서 사용할 수 있습니다. 메서드 또는 함수에서 적절한 기능을 찾지 못한다면, Mach 함수를 사용할 수 있습니다. 예를 들어, port_allocate() 및 msg_send() 는 많은 드라이버에서 사용됩니다.

Note: Instead of including the header file mach/mach.h, you must include mach/mach_user_internal.h and mach/mach_interface.h.
Note: mach/mach.h 헤더 파일을 포함(include)하는 대신에 'mach/mach_user_internal.h 와 mach/mach_interface.h 를 포함(include)해야합니다.

The host_priv_self() Mach function does not work in the kernel. You should use IOHostPrivSelf() instead.
host_priv_self() 라는 Mach 함수는 커널에서 작동하지 않습니다. 그 대신에 IOHostPrivSelf() 를 사용해야합니다.

범용 함수(General-Purpose Functions)

The general-purpose functions, defined in the header file driverkit/generalFuncs.h, provide a consistent interface for device drivers that may have to run in kernel space at one time (or in one configuration) and in user space at another time. Using these functions minimizes the work or porting between the two environments. All the Driver Kit classes, as well all NeXT kernel-level drivers that use the Driver Kit, were written using these functions so that they have one set of source files with minimal kernel and user mode differences.
헤더 파일 driverkit/generalFuncs.h 에 정의된 범용 함수는, 한 번(또는 하나의 설정(configuration))에 커널 공간에서 실행해야하는 장치 드라이버와 다른 시점에 사용자 공간에서 실행해야하는 경에 대한 일관된 인터페이스를 제공합니다. 이러한 기능을 사용하면 두 환경 간의 작업 또는 포팅이 최소화됩니다. Driver Kit 클래스 및 Driver Kit 을 사용하는 모든 NeXT 커널 수준 드라이버는, 이러한 기능을 사용해서 커널 및 사용자 모드의 차이가 최소한인 소스 파일 세트를 가지고 있도록 작성되었습니다.

Warning: Before using any of the general-purpose functions, each user-level driver must call IOInitGeneralFuncs(). (Kernel-level drivers don't need to call it.)
Warning: 각각의 사용자 수준 드라이버는 범용 함수를 사용하기 전에 IOInitGeneralFuncs() 를 호출해야합니다. (커널 수준 드라이버는 호출할 필요가 없습니다.)

스레드 함수(Thread Functions)

These functions provide the functionality of the C-thread functions in a uniform way in both user and kernel space.
이 함수는 사용자 및 커널 공간에서 일관된 방식으로 C 스레드 함수의 기능을 제공합니다.

IOForkThread()

IOSuspendThread()

IOResumeThread()

IOExitThread()

타이머 함수(Timer Functions)

IOSleep()

IODelay()

IOScheduleFunc()

IOUnscheduleFunc()

IOGetTimestamp()

메모리 할당 및 복사 함수(Memory Allocation and Copying Functions)

IOCopyMemory()

IOMalloc()

IOFree()

기타 범용 함수(Miscellaneous General-Purpose Functions)

IOInitGeneralFuncs()

IOFindNameForValue()

IOFindValueForName()

IOLog()

IOPanic()

드라이버 디버깅 모듈(DDM) 함수(Driver Debugging Module (DDM) Functions)

See the "Adding Debugging Code" section in Chapter 2 for information on using the DDM.
DDM 사용에 대한 정보는 2 장의 "Adding Debugging Code" 절을 참조하십시오.

IOAddDDMEntry()

IOClearDDM()

IOCopyString()

IODEBUG()

IOGetDDMEntry()

IOGetDDMMask()

IOInitDDM()

IONsTimeFromDDMMsg()

IOSetDDMMask()

기타 함수(Miscellaneous Functions)

커널 전용 함수(Kernel-Only Functions)

The function IOConvertPort() is necessary for some kernel-level drivers--and not for user-level drivers--because kernel-level drivers can execute in more than one task. The first thread of a kernel-level driver executes in the loadable kernel server's task, any threads that the driver creates execute in the kernel I/O task, and network drivers and drivers with UNIX entry points (at some stage) can execute in the context of an unknown task.
커널 수준 드라이버는 둘 이상의 작업을 실행할 수 있기 때문에, IOConvertPort() 함수는 일부 커널 수준 드라이버에는 필요하지만, 사용자 수준 드라이버에는 필요하지 않습니다. 커널 수준 드라이버의 첫 번째 스레드는 로드 가능한 커널 서버의 작업에서 실행되며, 드라이버가 만드는 모든 스레드는 커널 I/O 작업에서 실행되고, 네트워크 드라이버 및 UNIX 진입점(어떤 단계에서)이 있는 드라이버는 알 수 없는 작업(unknown task)의 컨텍스트에서 실행할 수 있습니다.

IOGetObjectForDeviceName() provides to kernel-level drivers some of the functionality provided to user-level programs by IODeviceMaster. Similarly, IOHostPrivSelf() is used by some kernel-level drivers that need the information normally returned by host_priv_self() (which is one of the few Mach functions that doesn't work in the kernel).
IOGetObjectForDeviceName() 은 IODeviceMaster 에 의해 사용자 수준 프로그램에 제공되는 일부 기능을 커널 수준 드라이버에 제공합니다. 마찬가지로, IOHostPrivSelf() 는 host_priv_self()(커널에서 작동하지 않는 소수의 Mach 함수 중 하나) 가 정상적으로 반환한 정보를 필요로하는 일부 커널 수준 드라이버에 의해 사용됩니다.

The function IOVmTaskSelf() supplies a vm_task_t for Mach function calls that expect one for the kernel; this is necessary because vm_task_t and task_t aren't the same in the kernel (as they are at user level). IOVmTaskCurrent() supplies a vm_task_t that's needed by some UNIX-style drivers. Finally, IOVmTaskForBuf() supplies a vm_task_t for the unknown task that is requesting UNIX-style I/O.
IOVmTaskSelf() 함수는 Mach 함수 호출을 위한 vm_task_t 를 제공하는데, 이는 커널 함수를 대기하게 됩니다; 이 상황은 vm_task_t 와 task_t 가 커널에서 동일하지 않기 때문에(사용자 수준에 있기 때문에) 필요합니다. IOVmTaskCurrent() 는 일부 UNIX 스타일 드라이버에 필요한 vm_task_t 를 제공합니다. 마지막으로 IOVmTaskForBuf() 는 UNIX 스타일의 I/O 를 요청하는 알 수 없는 작업(unknown task)에 대해 vm_task_t 를 제공합니다.

IOConvertPort()

IOGetObjectForDeviceName()

IOHostPrivSelf()

IOPhysicalFromVirtual()

IOSetUNIXError()

IOVmTaskCurrent()

IOVmTaskForBuf()

IOVmTaskSelf()

DMA 정렬 매크로(DMA Alignment Macros)

IOAlign()

IOIsAligned()

아키텍처 관련 함수(Architecture-Specific Functions)

The following functions are used by some Intel drivers to read and write I/O ports:
일부 인텔 드라이버는 다음 기능을 사용해서 I/O 포트를 읽고 씁니다(read/write):

inb()

inw()

inl()

outb()

outw()

outl()

Some Intel drivers use the following function to help handle interrupts:
일부 인텔 드라이버는 다음 함수를 사용해서 인터럽트를 처리합니다:

IODisableInterrupt()

IOEnableInterrupt()

IOSendInterrupt()

Some Intel devices require memory in the low 16 MB:
일부 인텔 장치는 16MB 이하의 메모리가 필요합니다:

IOMallocLow()

Intel display drivers often use the following functions to read and write VGA registers:
인텔 디스플레이 드라이버는 종종 다음 기능을 사용해서 VGA 레지스터를 읽고 씁니다(read/write):

IOReadRegister()

IOReadModifyWriteRegister()

IOWriteRegister()

DriverKitFunctions

inb(), inw(), inl(), outb(), outw(), outl()

Function inb(), inw(), inl(), outb(), outw(), outl()
요약	I/O 포트에 데이터 읽기 또는 쓰기
정의된 위치	driverkit/i386/ioPorts.h
개요	unsigned char inb(unsigned int address) unsigned short inw(unsigned int address) unsigned long inl(unsigned int address) void outb(unsigned int address, unsigned char data) void outw(unsigned int address, unsigned short data) void outl(unsigned int address, unsigned long data)
설명	These inline functions let drivers read and write I/O ports on Intel-based computers. Use inb() to read a byte at the I/O port address. Use inw() to read the two bytes at address and address + 1, and inl() to read four bytes starting at address. To write a byte, use outb(); to write two bytes (to address and address + 1), use outw(); to write four bytes, use outl(). 이러한 인라인 함수는 드라이버가 Intel 기반 컴퓨터에서 I/O 포트를 읽고 쓸 수 있도록 합니다. inb() 를 사용해서 I/O 포트 주소에서 바이트를 읽습니다. inw() 를 사용해서 주소의 두 바이트(two bytes)를 읽고, 주소에 1 을 더하고(address +1), inl() 으로 주소에서 시작하는 4 바이트를 읽어냅니다. 바이트를 쓰려면 outb() 를 사용하면 되는데, 두 바이트(two bytes)를(address 와 address + 1) 쓰려면(write), outw() 를 사용하고, 네 바이트(four bytes)쓰려면 outl() 을 사용하면 됩니다. These functions have nothing to do with main memory; they work only for the 64 kilobytes of I/O address space on an Intel-based computer. These functions use the special machine instructions that are necessary for reading and writing data from and to the I/O space. 이 함수들은 메인 메모리와 아무런 관련이 없으며, Intel 기반 컴퓨터에서 64KB 의 I/O 주소 공간(I/O address space)에서만 작동합니다. 이 함수들은 I/O 공간에서 데이터를 읽고 쓰는 데 필요한 특수 기계 명령어를 사용합니다. Note: These functions work only at kernel level and only on Intel-based computers. Note: 이러한 기능은 커널 수준에서만 작동하며 Intel 기반 컴퓨터에서만 작동합니다.
예제	temp_cr = inb(base+CR); /* get current CR value */

IOAddDDMEntry()

Function IOAddDDMEntry()
요약	드라이버 디버깅 모듈에 항목 하나 추가
정의된 위치	driverkit/debugging.h
개요	void IOAddDDMEntry(char *format, int arg1, int arg2, int arg3, int arg4, int arg5)
설명	This is the exported function that is used to add events to the DDM's circular buffer. However, drivers typically don't use this directly; instead, they should use macros that call IOAddDDMEntry() conditionally based on the current state of debugging flags. See the description of IODEBUG() for examples. 이것은 DDM 순환 버퍼에 이벤트를 추가하는 데 사용되는 내보내기 함수(exported function)입니다. 하지만 드라이버는 일반적으로 이를 직접 사용하지 않으며, 그 대신에 디버깅 플래그의 현재 상태에 따라 IOAddDDMEntry() 를 조건부로 호출하는 매크로를 사용하는것이 맞는 방법입니다. 예제는 IODEBUG() 설명을 참조하십시오. Note: The last 5 arguments to this function are typed above as int, but they are really untyped and could be any 32-bit quantity. They are stored in the debugging log as int but are eventually evaluated as arguments to sprintf(), so they could be int, char, short, or pointers to a string. See IOCopyString(), later in this section, for information on passing string pointers to IOAddDDMEntry(). Note: 이 함수가 필요로 하는 마지막 5 개의 인수는 int 로 입력되지만, 실제로는 타입이 지정된 것은 아니며, 32 비트 크기(변수 또는 상수)면 됩니다. 함수를 통해 받은 내용은 int 로 디버깅 로그에 저장됩니다만, 결국 sprintf() 에 대한 인수로 평가(evaluated)되므로 int, char, short 또는 문자열에 대한 포인터가 될 수 있습니다. 문자열 포인터를 IOAddDDMEntry() 에 전달하는 방법에 대한 자세한 내용은, 이 단원의 뒷부분에 나오는 IOCopyString() 을 참조하십시오.
관련항목	IODEBUG()

IOAddToBdevsw(), IOAddToCdevsw(), IOAddToVfssw()

Function IOAddToBdevsw(), IOAddToCdevsw(), IOAddToVfssw()
요약	드라이버 스위치 테이블에 UNIX 스타일 진입점(entry points) 추가
정의된 위치	driverkit/devsw.h
개요	int IOAddToBdevsw(IOSwitchFunc openFunc, IOSwitchFunc closeFunc, IOSwitchFunc strategyFunc, IOSwitchFunc dumpFunc, IOSwitchFunc psizeFunc, BOOL isTape) int IOAddToCdevsw(IOSwitchFunc openFunc, IOSwitchFunc closeFunc, IOSwitchFunc readFunc, IOSwitchFunc writeFunc, IOSwitchFunc ioctlFunc, IOSwitchFunc stopFunc, IOSwitchFunc resetFunc, IOSwitchFunc selectFunc, IOSwitchFunc mmapFunc, IOSwitchFunc getcFunc, IOSwitchFunc putcFunc) int IOAddToVfssw(const char *vfsswName, const struct vfsops *vfsswOps)
설명	These functions find a free row in a device switch table and add the specified entry points. Each function returns the major number (equivalent to the row number) for the device, or -1 if the device couldn't be added to the table. 이 함수는 드라이버 스위치 테이블에서 사용 가능한 행을 찾고 지정된 진입점(entry points)을 추가합니다. 각 함수는 드라이버의 주 번호 (행 번호에 해당)를 반환하며, 드라이버를 테이블에 추가 할 수 없는 경우 -1 을 반환합니다. Note: You should use IODevice's addToBdevsw... and addToCdevsw... methods instead of IOAddToBdevsw() and IOAddToCdevsw(), whenever possible. Note: 가능하다면 IOAddToBdevsw() 및 IOAddToCdevsw() 대신에, IODevice 의 addToBdevsw... 및 addToCdevsw... 메서드를 사용해야합니다.
관련항목	IORemoveFromBdevsw(), IORemoveFromCdevsw(), IORemoveFromVfssw()

IOAlign()

Function IOAlign()
요약	버퍼 크기에 맞춰지도록 주소(address)를 자릅니다.
정의된 위치	driverkit/align.h
개요	type IOAlign(type, address, bufferSize)
설명	이 매크로는 주소(address)를 bufferSize 의 배수로 자릅니다.
관련항목	IOIsAligned()

IOClearDDM()

Function IOClearDDM()
요약	드라이버 디버깅 모듈의 항목 지우기
정의된 위치	driverkit/debugging.h
개요	void IOClearDDM()
설명	이 함수는 DDM 의 순환 버퍼를 비웁니다.

IOConvertPort()

Function IOConvertPort()
요약	하나의 IPC 공간에서 다른 IPC 공간으로 포트 이름 변환
정의된 위치	driverkit/kernelDriver.h
개요	port_t IOConvertPort(port_t port, IOIPCSpace from, IOIPCSpace to)
설명	This function lets a kernel driver convert a port name (port) so that the port can be used in a different IPC space. Three types of conversion are supported: 이 함수는 커널 드라이버가 포트이름(port)을 변환해서 다른 IPC 공간에서 사용할 수 있도록 합니다. 세 가지 유형의 변환(conversion)이 지원됩니다. From the current task's IPC space to the kernel I/O task's space 현재 작업의 IPC 공간에서 커널 I/O 작업 공간으로 From the kernel's IPC space to the kernel I/O task's space 커널의 IPC 공간에서 커널 I/O 작업 공간까지 From the kernel I/O task's IPC space to kernel's IPC space 커널 I/O 태스크의 IPC 공간에서 커널의 IPC 공간까지 The arguments from and to should each be specified as one of the following: IO_Kernel, IO_KernelIOTask, or IO_CurrentTask. For example, the following code converts a port name from the current task's name to the name used by the kernel I/O task. from 및 to 인수는 각각 IO_Kernel, IO_KernelIOTask 또는 IO_CurrentTask 중에 하나로 지정되어야 합니다.예를 들어 다음 코드는 현재 작업 이름의 포트 이름을 커널 I/O 작업이 사용하는 이름으로 변환합니다. ioTaskPort = IOConvertPort(aPort, IO_CurrentTask, IO_KernelIOTask); Note: This function works only in kernel-level drivers. Note: 이 기능은 커널 수준 드라이버에서만 작동합니다.
반환	Returns the port's name in the to space. Specifying an invalid conversion results in a return value of PORT_NULL. 공간에 있는 포트 이름을 반환합니다. 잘못된 변환(invalid conversion)을 지정하면 반환값은 PORT_NULL 이 됩니다.

IOCopyMemory()

Function IOCopyMemory()
요약	지정된 전송 폭(transfer width)을 사용하여 메모리 복사
정의된 위치	driverkit/generalFuncs.h
개요	void IOCopyMemory(void *from, void *to, unsigned int numBytes, unsigned int bytesPerTransfer)
설명	Copies memory 1, 2, or 4 bytes at a time (as specified by bytesPerTransfer) until numBytes bytes starting at from have been copied to to. The from and to buffers must not overlap. from 에서 시작하는 numBytes 바이트가 to 로 복사 될 때까지 bytesPerTransfer 에서 지정한대로, 한번에 메모리 1, 2 또는 4 바이트를 복사합니다. This function is useful when devices have mapped memory that can be accessed in only 8-bit or 16-bit quantities. In these situations, bcopy() isn't appropriate, since it assumes 32-bit access to all memory involved. 이 기능은 디바이스가 8 비트 또는 16 비트 수량으로만 접근(accessed)할 수 있는 메모리를 매핑한 경우에 유용합니다. 이 경우 bcopy() 는 관련된 모든 메모리에 대한 32 비트 접근을 가정하기 때문에 적절하지 않습니다. If from is not aligned on a bytesPerTransfer boundary, IOCopyMemory() performs 8-bit transfers until it has reached a bytesPerTransfer boundary. Similarly, if the end of the from buffer extends past a bytesPerTransfer boundary, the remaining memory is copied 8 bits at a time. from 이 bytesPerTransfer 경계에 정렬되지 않은 경우 IOCopyMemory() 는 bytesPerTransfer 경계에 도달할 때까지 8 비트 전송을 수행합니다. 마찬가지로 From 버퍼의 끝이 bytesPerTransfer 경계를 넘어서 확장되면 나머지 메모리는 한번에 8 비트씩 복사됩니다.

IOCopyString()

Function IOCopyString()
요약	지정된 문자열의 복사를 반환
정의된 위치	driverkit/debugging.h
개요	const char *IOCopyString(const char *instring)
설명	This function is required when you want to use a pointer to a string whose existence is transitory as an argument. The reason for this is that the string won't be read until the Driver Debugging Module's buffer is examined, which could be a long time (minutes or more) after the call to IOAddDDMEntry(). By then, the string pointer passed to IOAddDDMEntry() no longer might no longer point to a useful string. 이 함수는 임시로 존재하는 문자열에 대한 포인터를 인수로 사용하려는 경우에 필요합니다. 왜냐하면, IOAddDDMEntry() 호출 후 오랜 시간(몇분 이상)이 될 수 있는 드라이버 디버깅 모듈의 버퍼가 검사될 때까지 문자열이 읽히지 않기 때문입니다. 그때까지 IOAddDDMEntry() 에 전달된 문자열 포인터는 더 이상 유용한 문자열을 가리키지 않습니다. Warning: The string returned by this function is created with IOMalloc() and is never freed. Use this function with discretion. Warning: 이 함수가 반환한 문자열은 IOMalloc() 을 사용해서 만들어지며 절대로 해제되지 않습니다. 이 함수는 신중하게 사용해야 합니다.

IODEBUG()

Function IODEBUG()
요약	조건부로 드라이버 디버깅 모듈에 항목을 하나 추가
정의된 위치	driverkit/debugging.h
개요	void IODEBUG(int index, int mask, char *format, int arg1, int arg2, int arg3, int arg4, int arg5)
설명	This macro is used to add entries to the DDM's circular buffer. The entry is added only if both of the following are true: 이 매크로는 DDM 순환 버퍼에 항목을 추가하는 데 사용됩니다. 다음 항목이 모두 참(true)인 경우에만 항목이 추가됩니다: The C preprocessor flag DDM_DEBUG is defined. C 선행 처리기 플래그(preprocessor flag) DDM_DEBUG 를 정의 A bitwise and operation performed on mask and IODDMMasks[index] results in a nonzero result. mask 및 IODDMMasks[index] 에서 수행되는 비트 연산에서 결과값이 0 이 아닌 다른값이 나올때 IODEBUG() is typically used to define other macros specific to a driver, as shown in the following example. IODEBUG() 는 일반적으로 다음 예제처럼 드라이버에 특정한 다른 매크로를 정의하는데 사용됩니다.
예제	#define MY_INDEX 0 #define MY_INPUT 0x00000001 // #define MY_OUTPUT 0x00000002 // #define MY_OTHER 0x00000004 // #define logInput(x, a, b, c, d, e) \ IODEBUG(MY_INDEX, MY_INPUT, x, a, b, c, d, e) #define logOutput(x, a, b, c, d, e) \ IODEBUG(MY_INDEX, MY_OUTPUT, x, a, b, c, d, e) #define logOther(x, a, b, c, d, e) \ IODEBUG(MY_INDEX, MY_OTHER, x, a, b, c, d, e) . . . IODDMMasks[MY_INDEX] = MY_INPUT | MY_OUTPUT; . . . logInput("Input error %d: %s\n", error, IOFindNameForValue(error,&errorList));

IODelay()

Function IODelay()
요약	표시된 microseconds 동안 대기(blocking 없이)
정의된 위치	driverkit/generalFuncs.h
개요	void IODelay(unsigned int microseconds)
설명	This is a quick, nonblocking version of IOSleep(). 이것은 IOSleep() 의 빠른 nonblocking 버전입니다. Note: This function guarantees a minimum "spin" delay in the user-level version; due to thread scheduling, the call to IODelay() could take much longer than the indicated time. This should not be a problem with properly designed user-level drivers as this is a common real-time constraint on all user-level code. Note: 이 함수는 사용자 수준 버전에서 최소의 "spin" 지연(delay)을 보장합니다. 또한 스레드 스케줄링으로 인해 IODelay() 에 대한 호출이 표시된 시간보다 훨씬 오래 걸릴 수 있습니다. 이 점은 모든 사용자 수준 코드에서 공통적인 실시간 제약 조건이므로 제대로 설계된 사용자 수준 드라이버 에서는 문제가 되지 않습니다.

IODisableInterrupt()

Function IODisableInterrupt()
요약	인터럽트 메시지 전송 방지
정의된 위치	driverkit/IODirectDevice.h
개요	void IODisableInterrupt(void *identity)
설명	This function allows handlers of non-shared interrupts to indicate that the interrupt should be left disabled on return from the interrupt handler. 이 함수는 공유되지 않는(non-shared) 인터럽트 핸들러가 인터럽트 핸들러에서 돌아 왔을때, 인터럽트를 비활성화 상태로 만드는걸 허용합니다. The identity argument should be set to the value that the interrupt handler received in its own arguments. identity 인수는 인터럽트 처리기가 자체 인수에서 받은 값으로 설정해야합니다. Note: IODisableInterrupt() must be called inside a special interrupt handler function. It can't be called from any other context. Note: IODisableInterrupt() 는 특별한 인터럽트 처리기 함수 내에서 호출되어야 합니다. 다른 상황에서는 호출 할 수 없습니다.
관련항목	IOEnableInterrupt(), IOSendInterrupt()

IOEnableInterrupt()

Function IOEnableInterrupt()
요약	인터럽트 메시지 전송 허용
정의된 위치	driverkit/IODirectDevice.h
개요	void IOEnableInterrupt(void *identity)
설명	This function allows interrupt handlers to indicate that the interrupt should be reenabled on return from the interrupt handler. You should only re-enable the interrupt after removing the source of the interrupt--by clearing the interrupt status register on the device, or by using whatever mechanism is necessary for the hardware your driver controls. 이 함수는 인터럽트 처리기가 인터럽트 핸들러에서 돌아 왔을 때 인터럽트를 다시 활성화 상태로 되돌리는걸 허용합니다. 인터럽트 원인을 제거한 후에는 디바이스의 인터럽트 상태 레지스터를 지우거나, 드라이버가 제어하는 ​​하드웨어에 필요한 메커니즘을 사용해서 인터럽트만 다시 활성화해야합니다. The identity argument should be set to the value that the interrupt handler received in its own arguments. identity 인수는 인터럽트 처리기가 자체 인수에서 받은 값으로 설정해야 합니다. Note: IOEnableInterrupt() must be called inside a special interrupt handler function. It can't be called from any other context. Note: IOEnableInterrupt() 는 특별한 인터럽트 처리기 함수 내에서 호출되어야 합니다. 다른 상황에서는 호출할 수 없습니다.
관련항목	IODisableInterrupt(), IOSendInterrupt()

IOExitThread()

Function IOExitThread()
요약	현재 스레드의 실행을 종료
정의된 위치	driverkit/generalFuncs.h
개요	volatile void IOExitThread()
설명	This function terminates the execution of the current (calling) thread. Note that there's no way for one thread to kill another thread other than by sending some kind of message to the soon-to-be-terminated thread instructing it to kill itself. 이 함수는 현재(호출된) 스레드의 실행을 종료합니다. 한 스레드가 다른 스레드를 죽일 수 있는 방법은 없다는 것을 명심하십시오. 곧 종료 될 스레드에게 일종의 메시지를 보내어 죽일 것을 명령합니다. Note: In the user-level implementation, the main C thread (the first thread in the task) doesn't exit until all other C threads in the task have exited. Note: 사용자 수준 구현에서 주 C 스레드(작업의 첫 번째 스레드)는 작업의 다른 모든 C 스레드가 종료될 때까지 종료되지 않습니다.

IOFindNameForValue(), IOFindValueForName()

Function IOFindNameForValue(), IOFindValueForName()
요약	IONamedValues ​​배열을 사용해서 정수를 문자열로 변환하거나 그 반대로 변환
정의된 위치	driverkit/generalFuncs.h
개요	const char *IOFindNameForValue(int value, const IONamedValues *array) IOReturn IOFindValueForName(const char *string, const IONamedValue *array, int *value)
설명	These functions are the primary use of the IONamedValues data type, which maps integer values to strings. IOFindNameForValue() maps a given integer value to a string, given a pointer to an array of IONamedValues. IOFindValueForName() maps a given string into an integer, returning the integer in value. 이러한 함수는 정수 값을 문자열에 매핑하는 IONamedValues ​​데이터 형식의 주요 용도입니다. IOFindNameForValue() 는 IONamedValues 의 배열을 가리키는 포인터에 주어진 정수 값을 문자열로 매핑합니다. IOFindValueForName() 은 지정된 문자열을 정수로 매핑해서 정수 값을 반환합니다. One typical use for IOFindNameForValue() is to map integer return values into error strings. IODevice's IOStringFromReturn: method performs this function. A subclass that defines additional IOReturn values should override this method and call [super IOReturnToString:] if the specified value does not match one of the class-specific IOReturns. IOFindNameForValue() 의 일반적인 용도 중 하나는 정수 반환 값을 오류 문자열에 매핑하는 것입니다. IODevice 의 IOStringFromReturn: 메서드가 이 기능을 수행합니다. 추가 IOReturn 값을 정의하는 하위 클래스는, 이 메서드를 재정의하고 지정된 값이 클래스 별 IOReturn 중 하나와 일치하지 않으면 [super IOReturnToString:] 을 호출해야 합니다.
반환	IOFindNameForValue() returns the string corresponding to value, or a string indicating that value is undefined if the integer wasn't found. IOFindValueForName() returns IO_R_SUCCESS if it finds the specified string; otherwise, it returns IO_R_INVALIDARG. IOFindNameForValue() 는 value 에 해당하는 문자열을 반환하고, 정수가 없으면 값이 정의되지 않음을 나타내는 문자열을 반환합니다.IOFindValueForName() 은 지정된 문자열을 찾으면 IO_R_SUCCESS 를 반환하며, 찾지 못했다면 IO_R_INVALIDARG 를 반환합니다.

IOForkThread()

Function IOForkThread()
요약	새로운 스레드를 시작
정의된 위치	driverkit/generalFuncs.h
개요	IOThread IOForkThread(IOThreadFunc function, void *arg)
설명	This function causes a new thread to be started up. For kernel-level drivers, the new thread is in the IOTask's address space; for user-level drivers, the thread is in the current task. The thread begins execution at function, which is passed arg as its argument. 이 함수로 새 스레드를 시작할 수 있습니다. 커널 레벨 드라이버의 경우 새 스레드는 IOTask 의 주소 공간에 있으며, 사용자 수준 드라이버의 경우 스레드가 현재 작업에 있습니다. 스레드는 arg 에서 인수를 전달하는 function 에서 실행을 시작합니다.

IOFree()

Function IOFree()
요약	IOMalloc() 에 의해 할당된 메모리를 해제
정의된 위치	driverkit/generalFuncs.h
개요	void IOFree(void *var, int numBytes)
설명	This function frees memory allocated by IOMalloc(). 이 함수는 IOMalloc() 에 의해 할당된 메모리를 해제합니다. Note: You must use the same value for numBytes as you used for the call to IOMalloc() that allocated the memory you're now freeing. Note: 현재 해제대상인 원래 메모리를 할당한 IOMalloc() 호출에 사용한 것과 동일한 numBytes 값을 사용해야합니다.

IOFreeLow()

Function IOFreeLow()
요약	IOMallocLow() 에 의해 할당된 메모리를 해제
정의된 위치	driverkit/i386/kernelDriver.h
개요	void IOFreeLow(void *var, int numBytes)
설명	This function frees memory allocated by IOMallocLow(). 이 함수는 IOMallocLow() 에 의해 할당 된 메모리를 해제합니다. Note: This function works only in kernel-level drivers. Note: 이 기능은 커널 수준 드라이버에서만 작동합니다.

IOGetDDMEntry()

Function IOGetDDMEntry()
요약	드라이버 디버깅 모듈에서 항목 가져 오기
정의된 위치	driverkit/debugging.h
개요	int IOGetDDMEntry(int entry, int outStringSize, char *outString, ns_time_t *timestamp, int *cpuNumber)
설명	Returns in outString an entry from the DDM. The entry argument should indicate which entry to return, counting backwards from the most recent entry. The timestamp argument is set to a value indicating the time at which the entry was logged. The cpuNumber argument is set to the number of the CPU that the retrieved entry is associated with. outString 에서 DDM 의 항목을 반환합니다. entry 인수는 가장 최근 항목에서 거꾸로 계산하여 반환할 항목을 표시해야 합니다. timestamp 인수는 항목이 기록된 시간을 나타내는 값으로 설정됩니다. cpuNumber 인수는 검색된 항목이 연관되어있는 CPU 번호로 설정됩니다.
반환	Returns a nonzero value if the specified entry doesn't exist. Otherwise, returns zero. 지정된 항목이 없다면 0 이 아닌 값을 반환합니다. 지정된 항목이 있으면 0 을 반환합니다.

IOGetDDMMask()

Function IOGetDDMMask()
요약	지정된 bitmask word 를 반환합니다.
정의된 위치	driverkit/debugging.h
개요	unsigned IOGetDDMMask(int index)
설명	This is typically not used by drivers; it provides a procedural means of obtaining a specified bitmask value. For performance reasons, the macros that filter and call IOAddDDMEntry() typically read the index words directly (the IODDMMasks array is a global variable). 이 함수를 일반적으로 드라이버에서 사용하는것은 아니지만, 지정된 비트 마스크 값을 얻는 절차적 수단을 제공합니다. 성능상의 이유 때문에 IOAddDDMEntry() 를 필터링하고 호출하는 매크로는 일반적으로 인덱스 단어를 직접 읽습니다(IODDMMasks 배열은 전역 변수입니다.)