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 배열은 전역 변수입니다.)

IOGetObjectForDeviceName()

Function IOGetDDMMask()
요약	이름을 가진 커널 장치의 ID를 얻습니다.
정의된 위치	driverkit/kernelDriver.h
개요	IOReturn IOGetObjectForDeviceName(IOString deviceName, id *deviceId)
설명	This function provides a simple mapping of device names to objects. Since this is valid only at kernel level, no security mechanism is provided; any kernel code can get the id of any kernel IODevice. 이 함수는 객체에 대한 장치 이름의 간단한 매핑을 제공합니다. 이것은 커널 레벨에서만 유효하기 때문에 보안 메커니즘이 제공되지 않습니다. 모든 커널 코드는 모든 커널 IODevice 의 ID 를 얻을 수 있습니다. Note: This function works only in kernel-level drivers. Note: 이 기능은 커널 수준 드라이버에서만 작동합니다.
반환	Returns IO_DR_NOT_ATTACHED if deviceName isn't found; otherwise returns IO_R_SUCCESS. deviceName 을 찾을 수 없는 경우 IO_DR_NOT_ATTACHED 를 반환합니다. 찾을 수 있다면 IO_R_SUCCESS를 반환합니다.

IOGetTimestamp()

Function IOGetDDMMask()
요약	마이크로 초 수준의 정확한 현재 타임 스탬프를 얻습니다.
정의된 위치	driverkit/generalFuncs.h
개요	void IOGetTimestamp(ns_time_t *nsp)
설명	This function obtains a quick, microsecond-accurate, system-wide timestamp. 이 함수는 마이크로 초 단위의 신속한 시스템 전체 타임 스탬프를 얻습니다.

IOHostPrivSelf()

Function IOGetDDMMask()
요약	커널 I/O 작업의 권한있는 호스트 포트의 버전을 반환합니다.
정의된 위치	driverkit/kernelDriver.h
개요	port_t IOHostPrivSelf()
설명	This function is necessary because the Mach function host_priv_self() doesn't work at kernel level. Mach 함수인 host_priv_self() 는 커널 레벨에서 작동하지 않기 때문에 이 함수가 필요합니다. Note: This function works only in kernel-level drivers. In user-level drivers, use host_priv_self() instead. 이 기능은 커널 수준 드라이버에서만 작동합니다. 사용자 수준 드라이버에서는 이 기능 대신에 host_priv_self() 를 사용하십시오.

IOInitDDM()

Function IOGetDDMMask()
요약	드라이버 디버깅 모듈 초기화
정의된 위치	driverkit/debugging.h
개요	Kernel level: void IOInitDDM(int numBufs) User level: void IOInitDDM(int numBufs, char *serverPortName)
설명	This function must be called once by your driver before calling any other DDM functions. 이 함수는 다른 DDM 함수를 호출하기 전에 드라이버에서 한번 호출해야 합니다.

IOInitGeneralFuncs()

Function IOGetDDMMask()
요약	범용 함수 초기화(Initialize the general-purpose functions)
정의된 위치	driverkit/generalFuncs.h
개요	void IOInitGeneralFuncs()
설명	Each user-level driver must call IOInitGeneralFuncs() once before calling any other functions declared in the driverkit/generalFuncs.h header file. 각 사용자 수준 드라이버는 driverkit/generalFuncs.h 헤더 파일에 선언된 다른 함수를 호출하기 전에 IOInitGeneralFuncs() 를 한 번 호출해야합니다. Note: Kernel-level drivers don't need to call this function, because it's automatically called by the kernel. Note: 커널 수준 드라이버는 커널에 의해 자동으로 호출되기 때문에이 함수를 호출할 필요가 없습니다.

IOIsAligned()

Function IOGetDDMMask()
요약	주소 정렬 여부 결정(Determine whether an address is aligned)
정의된 위치	driverkit/align.h
개요	unsigned int IOIsAligned(address, bufferSize)
설명	This macro returns a nonzero value if address is a multiple of bufferSize; otherwise, it returns 0. 이 매크로는 address 가 bufferSize 의 배수이면 0 이 아닌 값을 반환하며, 그렇지 않은 경우에는 0 을 반환합니다.

IOLog()

Function IOGetDDMMask()
요약	문자열을 시스템 로그에 추가합니다.
정의된 위치	driverkit/generalFuncs.h
개요	void IOLog(const char *format, ...)
설명	This is the Driver Kit's substitute for printf(); its implementation is similar to syslog(). IOLog() logs the string to /usr/adm/messages by default; you can specify another destination in the configuration file /etc/syslog.conf. The arguments are stdargs, just as for printf(). This function doesn't block on single-processor systems. It runs at level LOG_ERR and its facility is kern. 이것은 Driver Kit 에서 사용되는 printf() 의 대체품이며, 구현은 syslog() 와 유사합니다. IOLog() 는 기본적으로 문자열을 /usr/adm/messages 에 기록하며, /etc/syslog.conf 설정파일에서 에서 다른 기록 대상을 지정할 수 있습니다. 인수는 printf() 와 마찬가지로 stdargs 입니다. 이 기능은 단일 프로세서 시스템에서는 차단되지 않습니다. 이것은 LOG_ERR 수준에서 실행되며 커널의 기능입니다. SEE ALSO printf(3) UNIX manual page, syslog(3) UNIX manual page 관련 항목으로 printf (3) UNIX 매뉴얼 페이지, syslog (3) UNIX 매뉴얼 페이지를 참고.

IOMalloc()

Function IOGetDDMMask()
요약	표준 메모리 할당자(Standard memory allocator)
정의된 위치	driverkit/generalFuncs.h
개요	oid *IOMalloc(int numBytes)
설명	This function causes numBytes bytes of memory to be allocated; a pointer to the memory is returned. No guarantees exist as to the alignment or the physical contiguity of the allocated memory, but when IOMalloc() is called at kernel-level, the allocated memory is guaranteed to be wired down. Memory allocated with IOMalloc() should be freed with IOFree(). 이 함수는 numBytes 바이트의 메모리를 할당하며, 메모리에 대한 포인터를 반환합니다. 할당 된 메모리의 정렬 또는 물리적 인접성에 대한 보장은 없지만 IOMalloc() 이 커널 수준에서 호출될 때 할당된 메모리는 끝까지(wired down) 보장됩니다. IOMalloc() 으로 할당된 메모리는 IOFree() 로 해제해야합니다. Warning: If no memory is available, IOMalloc() blocks until it can obtain memory. For this reason, you shouldn't call IOMalloc() from a direct interrupt handler. 경고: 사용할 수있는 메모리가 없으면 IOMalloc() 는 메모리를 확보할 수 있을 때까지 차단됩니다.따라서 직접 인터럽트 핸들러에서 IOMalloc() 를 호출해서는 안됩니다. Drivers that can control (directly or indirectly) disks, network cards, or other devices used by a file system can run into a deadlock situation if they use IOMalloc() during I/O. This deadlock can occur when the pageout daemon attempts to free memory by moving pages out to disk. When the pageout daemon requests this I/O and the driver uses IOMalloc() to request more memory than is available, IOMalloc() blocks. The result is deadlock: the driver can't perform the I/O until memory is freed, and the memory can't be freed by the pageout daemon until the I/O happens. In general, a driver can avoid this deadlock by not allocating large amounts of memory during I/O. For example, allocating less than 100 bytes is safe, but allocating 8K bytes is very unsafe. 파일 시스템에서 사용되는 디스크, 네트워크 카드 또는 기타 장치를 (직접 또는 간접적으로) 제어할 수 있는 드라이버는 I/O 중에 IOMalloc() 을 사용하면 교착 상태(deadlock)에 빠질 수 있습니다. 이 교착 상태는 pageout 데몬이 페이지를 디스크로 이동하여 메모리를 확보하려고 할 때 발생할 수 있습니다. pageout 데몬이 이 I/O 를 요청하고 드라이버가 IOMalloc() 을 사용해서 사용 가능한 것보다 많은 메모리를 요청한다면 IOMalloc() 은 차단됩니다. 결과는 교착 상태가 되며, 드라이버는 메모리가 해제될 때까지 I/O 를 수행할 수 없으며, I/O 가 발생할 때까지 메모리를 pageout 데몬에서 해제할 수 없습니다. 일반적으로 드라이버는 I/O 진행중에 많은 양의 메모리를 할당하지 않는것으로 이러한 교착 상태를 피할 수 있습니다. 예를 들어, 100 바이트 미만 할당은 안전하지만 8K 바이트를 할당하는 것은 매우 안전하지 않습니다.

IOMallocLow()

Function IOGetDDMMask()
요약	16MB 이하의 컴퓨터 메모리 범위에 메모리를 할당합니다.
정의된 위치	driverkit/i386/kernelDriver.h
개요	void *IOMallocLow(int numBytes)
설명	This function acts like IOMalloc(), except that the allocated range of memory is guaranteed to be in the low 16MB of system memory and to be physically contiguous. This function is provided because some cards for Intel-based computers must be mapped to low memory. Memory allocated with IOMallocLow() should be freed with IOFreeLow(). 이 기능은 IOMalloc() 과 동일하게 작동되지만, 할당되는 메모리 범위가 시스템 메모리의 16MB 미만에 물리적으로 인접되어야합니다. Intel 기반 컴퓨터의 일부 카드는 낮은 메모리에 매핑해야하기 때문에 이 기능이 제공됩니다. IOMallocLow() 으로 할당된 메모리는 IOFreeLow() 로 해제해야 합니다. Note: This function works only in kernel-level drivers running on Intel-based computers. Note: 이 함수는 Intel 기반 컴퓨터에서 실행되는 커널 수준 드라이버에서만 작동합니다.

IOMapPhysicalIntoIOTask

Function IOGetDDMMask()
요약	실제 주소 범위를 IOTask 의 주소 공간에 매핑하십시오
정의된 위치	driverkit/kernelDriver.h
개요	IOReturn IOMapPhysicalIntoIOTask(unsigned physicalAddress, unsigned length, vm_address_t *virtualAddress)
설명	This function maps a range of physical memory into your IOTask. It returns the virtual address at which the range is mapped in the virtualAddress argument. 이 함수는 물리적 메모리의 범위를 IOTask 에 매핑합니다. virtualAddress 인수에 범위가 매핑되는 가상 주소를 반환합니다. Note: This function works only in kernel-level drivers. Note: 이 함수는 커널 수준 드라이버에서만 작동합니다.
반환	Returns an error if the specified physical range could not be mapped; otherwise, returns IO_R_SUCCESS. 지정된 물리적 범위를 매핑 할 수 없는 경우라면 오류를 반환하며, 그렇지 않으면 IO_R_SUCCESS 를 반환합니다.
관련항목	IOUnmapPhysicalFromIOTask()

IONsTimeFromDDMMsg()

Function IOGetDDMMask()
요약	드라이버 디버깅 모듈 메시지에서 시간 추출
정의된 위치	driverkit/debuggingMsg.h
개요	ns_time_t IONsTimeFromDDMMsg(IODDMMsg *msg)
설명	This inline function combines the timestampHighInt and timestampLowInt fields from msg and returns the result. 이 인라인 함수는 msg 의 timestampHighInt 및 timestampLowInt 필드를 결합한 결과를 반환합니다.

IOPanic()

Function IOGetDDMMask()
요약	panic 또는 메모리 덤프 후 문자열을 콘솔에 기록
정의된 위치	driverkit/generalFuncs.h
개요	void IOPanic(const char *reason)
설명	The reason argument is logged to the console, after which either a kernel panic (if in kernel space) or a memory dump (if in user space) occurs. reason 인수가 콘솔에 기록되고, 커널 패닉(커널 공간에있는 경우) 또는 메모리 덤프(사용자 공간에있는 경우)가 발생합니다. Note: Use of this function is an extreme measure. Use IOPanic() only when continued execution may cause system corruption. Note: 이 기능의 사용은 극단적인 방법입니다. 계속 실행하면 시스템이 손상될 수있는 경우에만 IOPanic() 을 사용하십시오.

IOPhysicalFromVirtual()

Function IOGetDDMMask()
요약	가상 주소에 해당하는 실제 주소를 찾습니다.
정의된 위치	driverkit/kernelDriver.h
개요	IOReturn IOPhysicalFromVirtual(vm_task_t task, vm_address_t virtualAddress, unsigned int *physicalAddress)
설명	This function gets the physical address (if any) that corresponds to virtualAddress. It returns IO_R_INVALID_ARG if no physical address corresponds to virtualAddress. On success, it returns IO_R_SUCCESS. If virtualAddress is in the current task, then the task argument should be set to IOVmTaskSelf(). This function will never block. Use this function only to find the physical address of wired down memory since the physical address of unwired down memory might change over time. 이 함수는 virtualAddress 에 해당하는 실제 주소(있을 경우)를 가져옵니다. virtualAddress 에 대응하는 물리적 주소가 없으면 IO_R_INVALID_ARG 를 반환합니다. 성공하면 IO_R_SUCCESS 를 반환합니다. virtualAddress 가 현재 작업에 있다면, 작업의 인수는 IOVmTaskSelf() 로 설정되어야 합니다. 이 기능은 결코 차단되지 않습니다. 연결 해제 된 메모리의 실제 주소는 시간이 지남에 따라 변경될 수 있으므로 메모리한계의 실제 주소를 찾는 경우에만 이 기능을 사용하십시오. Note: This function is available only at kernel level. This function shouldn't be used in a custom interrupt handler--it can't run at the interrupt level. Note: 이 함수는 커널 수준에서만 사용할 수 있습니다. 또한 함수를 사용자 정의 인터럽트 처리기에서 사용하면 안됩니다. 인터럽트 수준에서 실행할 수 없습니다.

IOReadRegister(), IOWriteRegister(), IOReadModifyWriteRegister()

Function IOGetDDMMask()
요약	디스플레이 레지스터 값 읽기 또는 쓰기
정의된 위치	driverkit/i386/displayRegisters.h
개요	unsigned char IOReadRegister( IOEISAPortAddress port, unsigned char index) void IOWriteRegister( IOEISAPortAddress port, unsigned char index, unsigned char value) void IOReadModifyWriteRegister( IOEISAPortAddress port, unsigned char index, unsigned char protect, unsigned char value)
설명	These inline functions perform operations commonly used to read or write display registers. IOReadRegister reads and returns the value of the register specified by port and index. IOWriteRegister() writes value to the register specified by port and index. IOReadModifyWriteRegister() reads the specified register, zeroes every bit that isn't set in the protect mask, sets every bit that's set in value, and sets the register to the new value. When the protect mask is zero, the effect is to set the register to value. 이러한 인라인 함수는 디스플레이 레지스터를 읽거나 쓰는 데 일반적으로 사용되는 연산을 수행합니다. IOReadRegister 는 port 와 index 에 지정된 레지스터 값을 읽고 반환합니다. IOWriteRegister() 는 port 와 index 에 지정된 레지스터에 값을 씁니다. IOReadModifyWriteRegister() 는 지정된 레지스터를 읽고, 보호 마스크에 설정되지 않은 모든 비트를 0 으로 설정하며, value 로 설정된 모든 비트를 설정한 다음 레지스터를 새 value 로 설정합니다. 보호 마스크가 0 일때에는, 레지스터를 value 로 설정하는 효과가 나타납니다. Note: These functions are supported only on Intel-based computers. Note: 이 함수는 Intel 기반 컴퓨터에서만 지원됩니다.

IORemoveFromBdevsw(), IORemoveFromCdevsw(), IORemoveFromVfssw()

Function IOGetDDMMask()
요약	장치 전환 표에서 UNIX 스타일 진입점 제거(Remove UNIX-style entry points from a device switch table)
정의된 위치	driverkit/devsw.h
개요	void IORemoveFromBdevsw(int bdevswNumber) void IORemoveFromCdevsw(int cdevswNumber) void IORemoveFromVfssw(int vfsswNumber)
설명	These functions remove a device from a device switch table, replacing it with a null entry. 이 함수는 장치 전환 테이블에서 장치를 제거하고 null 항목으로 엎어 씌웁니다. Note: You should use IODevice's removeFromBdevsw and removeFromCdevsw methods instead of IORemoveFromBdevsw() and IORemoveFromCdevsw(), whenever possible. Note: 가능할 때마다 IORemoveFromBdevsw() 및 IORemoveFromCdevsw() 대신에, IODevice 의 removeFromBdevsw 및 removeFromCdevsw 메소드를 사용해야 합니다.

IOResumeThread()

Function IOGetDDMMask()
요약	IOSuspendThread() 로 일시 중단된 스레드의 실행 재개
정의된 위치	driverkit/generalFuncs.h
개요	void IOResumeThread(IOThread thread)
설명	This function causes the execution of a suspended thread to continue. 이 함수는 중단된 스레드의 실행을 재개합니다.

IOScheduleFunc()

Function IOGetDDMMask()
요약	앞으로 특정 시간에 지정된 함수가 호출되도록 배열하십시오.
정의된 위치	driverkit/generalFuncs.h
개요	void IOScheduleFunc(IOThreadFunc function, void *arg, int seconds)
설명	This function causes function to be called in seconds seconds, with arg as function's argument. The call to function occurs in the context of the caller's task, but in a thread that is unique to the Driver Kit. The call to function can be cancelled with IOUnscheduleFunc(). 이 함수는 함수가 인수로 초 초 단위(seconds seconds)로 호출되도록 합니다. 함수 호출은 호출자의 작업 컨텍스트에서 발생하지만 드라이버 키트에 고유한 스레드에서 발생됩니다. 함수 호출은 IOUnscheduleFunc() 로 취소할 수 있습니다. Note: The kernel version of IOScheduleFunc() performs the callback in the kernel task's context, not the I/O Task context. One consequence is that function can't send Mach messages with msg_send(); it needs to use msg_send_from_kernel() instead, as described in Chapter 2. Note: IOScheduleFunc() 의 커널 버전은 I/O 작업 컨텍스트가 아닌 커널 작업의 컨텍스트에서 콜백을 수행합니다. 한가지 중요한 점은, 함수가 msg_send() 로는 Mach 메시지를 보낼 수 없다는 것입니다. 2 장에서 설명한 것처럼 그 대신에 msg_send_from_kernel() 을 사용해야 합니다.

IOSendInterrupt()

Function IOGetDDMMask()
요약	인터럽트 메시지 전송을 위한 배열
정의된 위치	driverkit/IODirectDevice.h
개요	void IOSendInterrupt(void *identity, void *state, unsigned int msgId)
설명	This function is useful if you need to handle interrupts directly--for example, because of a timing constraint in the hardware--but don't wish to give up the advantages of interrupt notification by messages. To handle interrupts directly, you must implement the getHandler:level:argument:forInterrupt: message of IODirectDevice. 이 함수는 인터럽트를 직접 처리해야 하지만(예를 들어 하드웨어의 타이밍 제약 때문에), 메시지로 인터럽트 알림의 이점을 포기하지 않으려는 경우에 유용합니다. 인터럽트를 직접 처리하려면 IODirectDevice 의 getHandler:level:argument:forInterrupt: 메시지를 구현해야합니다. The msgId argument specifies the message ID of the interrupt message that will be sent. This should be IO_DEVICE_INTERRUPT_MSG unless the driver's documentation specifies otherwise. The identify and state arguments should be set to the values that the interrupt handler received in its own arguments. For example (italicized text delineated in angle brackets, that is << >>, is to be filled in with device-specific code): msgId 인수는 보낼 인터럽트 메시지의 메시지 ID 를 지정합니다. 드라이버 설명서에서 별도로 지정되지 않았다면 IO_DEVICE_INTERRUPT_MSG 여야합니다. 식별 및 상태 인수는 인터럽트 처리기가 자체 인수에서 받은 값으로 설정해야 합니다. 예를 들어 (꺾쇠 괄호로 표시된 기울임 꼴 텍스트, 즉 << >> 는 장치 관련 코드로 채워집니다): static void myInterruptHandler(void *identity, void *state, unsigned int arg) { << handle the interrupt >> IOSendInterrupt(identity, state, IO_DEVICE_INTERRUPT_MSG); }
관련항목	IODisableInterrupt(), IOEnableInterrupt()

IOSetDDMMask()

Function IOGetDDMMask()
요약	지정된 비트 마스크 word 를 지정된 값으로 설정합니다.
정의된 위치	driverkit/debugging.h
개요	void IOSetDDMMask(int index, unsigned int bitmask)
설명	This is typically used by individual user-level drivers at initialization time, if then. Subsequently, it is usually used only by the Driver Debugging Module's server thread to change the current bitmask value. 이 경우 일반적으로 개별 사용자 수준 드라이버가 초기화 시간에 사용되며, 그 다음에는 일반적으로 드라이버 디버깅 모듈의 서버 스레드에서만 현재 비트 마스크 값을 변경하는 데 사용됩니다. The index argument is an index into IODDMMasks, which is an array of unsigned int. Each entry of the array contains 32 mask bits. index 인수는 IODDMMasks 에 대한 색인이며 부호없는 int 배열입니다. 배열의 각 항목에는 32 개의 마스크 비트가 포함됩니다.

IOSetUNIXError()

Function IOGetDDMMask()
요약	UNIX 스타일 드라이버에서 오류 값을 명시적(Explicitly)으로 반환합니다.
정의된 위치	driverkit/kernelDriver.h
개요	void IOSetUNIXError(int errno)
설명	Most UNIX-style drivers don't need to use this function. However, those that explicitly set the caller's errno can use this function to do so. This function is used when the caller executes as a result of a UNIX-style entry point. 대부분의 UNIX 스타일 드라이버는 이 함수를 사용할 필요가 없습니다. 그러나 호출자의 errno 를 명시적으로 설정하는 함수는 이 함수를 사용해서 호출자의 errno 를 사용할 수 있습니다. 이 함수는 호출자가 UNIX 스타일의 진입점의 결과로 실행될 때 사용됩니다. Note: This function works only in kernel-level drivers. Note: 이 함수는 커널 수준 드라이버에서만 작동합니다.

IOSleep()

Function IOGetDDMMask()
요약	지시된 밀리 초 동안 sleep
정의된 위치	driverkit/generalFuncs.h
개요	void IOSleep(unsigned int milliseconds)
설명	This function causes the caller to block for the indicated number of milliseconds. 이 함수는 호출자가 표시된 밀리 초 동안 차단하도록 합니다.

IOSuspendThread()

Function IOGetDDMMask()
요약	IOForkThread() 로 시작된 스레드의 실행을 일시 중단합니다.
정의된 위치	driverkit/generalFuncs.h
개요	void IOSuspendThread(IOThread thread)
설명	This function causes the execution of a running thread to pause. The thread can be resumed with IOResumeThread(). 이 함수는 실행중인 스레드의 실행을 일시 중지시킵니다. IOResumeThread() 로 스레드를 다시 시작할 수 있습니다.

IOUnmapPhysicalFromIOTask

Function IOGetDDMMask()
요약	IOTask 의 주소 공간에서 실제 주소 범위 매핑 해제
정의된 위치	driverkit/kernelDriver.h
개요	IOReturn IOUnmapPhysicalFromIOTask(vm_address_t virtualAddress, unsigned length)
설명	This function unmaps a range of memory that was mapped with IOMapPhysicalIntoIOTask(). You should use this to destroy a mapping when you no longer need to use it. 이 함수는 IOMapPhysicalIntoIOTask() 로 매핑된 메모리 범위를 매핑 해제합니다. 더 이상 사용할 필요가 없는 맵핑을 제거하려면 이 옵션을 사용해야 합니다. Note: This function works only in kernel-level drivers. Note: 이 함수는 커널 수준 드라이버에서만 작동합니다.
반환	Returns an error if the specified virtual range was not mapped by IOMapPhysicalIntoIOTask(); otherwise, returns IO_R_SUCCESS. 지정된 가상 범위가 IOMapPhysicalIntoIOTask() 에 의해 매핑되지 않은 경우에는 오류를 반환합니다. 그렇지 않으면 IO_R_SUCCESS 를 반환합니다.	관련항목	IOMapPhysicalIntoIOTask()

IOUnscheduleFunc()

Function IOGetDDMMask()
요약	IOScheduleFunc() 로 만든 요청을 취소
정의된 위치	driverkit/generalFuncs.h
개요	void IOUnscheduleFunc(IOThreadFunc function, void *arg)
설명	This function removes a request made using IOScheduleFunc() from the current list of pending requests. An error will be logged to the console if the specified function/arg pair is not currently registered. 이 함수는 현재 보류중인 요청 목록중에서 IOScheduleFunc() 을 사용해서 만들어진 요청을 제거합니다. 지정된 함수/arg 쌍이 현재 등록되지 않았다면 오류가 콘솔에 기록됩니다.

IOVmTaskCurrent()

Function IOGetDDMMask()
요약	현재 작업의 vm_task_t 를 반환합니다.
정의된 위치	driverkit/kernelDriver.h
개요	vm_task_t IOVmTaskCurrent()
설명	Returns the vm_task_t for the current task. The only reason to use this function is to perform DMA to user space memory transfers in a UNIX-style driver. 현재 태스크의 vm_task_t 를 반환합니다. 이 기능을 사용하는 유일한 이유는 UNIX 스타일 드라이버에서 DMA 를 사용자 공간 메모리 전송을 수행하기 위해서 입니다. Note: This function works only in kernel-level drivers. Note: 이 기능은 커널 수준 드라이버 에서만 작동합니다.
관련항목	IOVmTaskSelf()

IOVmTaskForBuf()

Function IOGetDDMMask()
요약	buf 구조체와 관련된 vm_task_t 를 반환합니다.
정의된 위치	driverkit/kernelDriver.h
개요	vm_task_t IOVmTaskForBuf(struct buf *buffer)
설명	Block drivers use this function to determine the task for which they're doing I/O. The value returned by this function is used in calls to IOPhysicalFromVirtual(), which returns an address that's used in IODirectDevice's createDMABufferFor:... method. 블록 드라이버는이 기능을 사용하여 I/O 작업을 결정합니다. 이 함수가 반환하는 값은 IODirectDevice 의 createDMABufferFor:... 메서드에서 사용되는 주소를 반환하는 IOPhysicalFromVirtual() 에 대한 호출에서 사용됩니다. Note: This function works only in kernel-level drivers. Note: 이 함수는 커널 수준 드라이버에서만 작동합니다.

IOVmTaskSelf()

Function IOGetDDMMask()
요약	커널의 vm_task_t 를 얻는다.
정의된 위치	driverkit/kernelDriver.h
개요	vm_task_t IOVmTaskSelf()
설명	This function is used to obtain the kernel's vm_task_t, which is the vm_task_t for memory allocated with IOMalloc(). This function is required because the type definition of vm_task_t at kernel level is different from that of vm_task_t at user level. 이 함수는 IOMalloc() 으로 할당된 메모리의 vm_task_t 인 커널의 vm_task_t 를 얻는데 사용됩니다. 이 함수는 커널 수준의 vm_task_t 형식 정의(type definition)가 사용자 수준의 vm_task_t 형식 정의와 다르기 때문에 필요합니다. Note: This function works only in kernel-level drivers. Note: 이 함수는 커널 수준 드라이버에서만 작동합니다.