WDM 정보 가져오기

[KMDF에만 적용]

프레임워크는 드라이버가 WDM 정의 정보를 가져올 수 있도록 하는 여러 개체 메서드를 제공합니다.

드라이버 및 해당 디바이스에 대한 WDM 정보 가져오기

드라이버 및 해당 디바이스에 대한 WDM 정보를 가져오기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfFdoInitWdmGetPhysicalDevice
디바이스의 물리적 디바이스 개체(PDO)를 나타내는 DEVICE_OBJECT 구조를 검색합니다. 드라이버가 디바이스에 대한 프레임워크 디바이스 개체를 만들기 전에 드라이버가 이 메서드를 호출할 수 있습니다.

WdfDeviceWdmGetPhysicalDevice
디바이스의 PDO를 나타내는 WDM DEVICE_OBJECT 구조를 검색합니다. 드라이버는 디바이스에 대한 프레임워크 디바이스 개체를 만든 후 이 메서드를 호출할 수 있습니다.

WdfDeviceWdmGetDeviceObject
지정된 프레임워크 디바이스 개체와 연결된 WDM 디바이스 개체를 반환합니다.

WdfDeviceWdmGetAttachedDevice
디바이스 스택에서 다음으로 낮은 WDM 디바이스 개체를 반환합니다.

WdfWdmDeviceGetWdfDeviceHandle
지정된 WDM 디바이스 개체와 연결된 프레임워크 디바이스 개체에 대한 핸들을 반환합니다.

WdfWdmDriverGetWdfDriverHandle
지정된 WDM 드라이버 개체와 연결된 프레임워크 드라이버 개체에 대한 핸들을 반환합니다.

I/O 요청에 대한 WDM 정보 가져오기

I/O 요청에 대한 WDM 정보를 얻기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfRequestWdmGetIrp
지정된 프레임워크 요청 개체와 연결된 WDM IRP 구조를 반환합니다. 반면에 프레임워크 외부에서 WDM IRP를 수신하는 드라이버는 WdfRequestCreateFromIrp를 호출하여 IRP에 대한 프레임워크 요청 개체를 만들 수 있습니다.

WdfRequestGetParameters
지정된 프레임워크 요청 개체와 연결된 매개 변수를 검색합니다. 이러한 매개 변수의 대부분은 요청의 WDM I/O 스택 위치에서 가져옵니다.)

WdfRequestRetrieveOutputWdmMdl
I/O 요청의 출력 버퍼를 나타내는 MDL(메모리 설명자 목록)을 검색합니다.

WdfRequestRetrieveInputWdmMdl
I/O 요청의 입력 버퍼를 나타내는 MDL을 검색합니다.

WdfRequestFormatRequestUsingCurrentType
호출 드라이버의 I/O 스택 위치의 내용을 드라이버의 로컬 I/O 대상의 I/O 스택 위치에 복사합니다.

WdfRequestWdmFormatUsingStackLocation
드라이버의 로컬 I/O 대상에 대한 I/O 스택 위치의 내용을 설정합니다.

I/O 대상에 대한 WDM 정보 가져오기

I/O 대상에 대한 WDM 정보를 얻기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfIoTargetWdmGetTargetDeviceObject
로컬 또는 원격 I/O 대상과 연결된 WDM 디바이스 개체에 대한 포인터를 반환합니다.

WdfIoTargetWdmGetTargetFileObject
원격 I/O 대상과 연결된 WDM FILE_OBJECT 구조체에 대한 포인터를 반환합니다.

WdfIoTargetWdmGetTargetFileHandle
원격 I/O 대상과 연결된 파일에 대한 핸들을 반환합니다.

WdfIoTargetWdmGetTargetPhysicalDevice
원격 I/O 대상의 디바이스를 나타내는 WDM PDO(물리적 디바이스 개체)에 대한 포인터를 반환합니다.

인터럽트 및 DPC에 대한 WDM 정보 가져오기

인터럽트 및 DPC(지연 프로시저 호출)에 대한 WDM 정보를 얻기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfInterruptWdmGetInterrupt
지정된 프레임워크 인터럽트 개체와 연결된 WDM KINTERRUPT 구조체에 대한 포인터를 반환합니다.

WdfDpcWdmGetDpc
지정된 프레임워크 DPC 개체와 연결된 WDM KDPC 구조체에 대한 포인터를 반환합니다.

USB I/O 대상에 대한 WDM 정보 가져오기

USB I/O 대상에 대한 WDM 정보를 얻기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfUsbTargetPipeWdmGetPipeHandle
지정된 프레임워크 파이프 개체와 연결된 USBD_PIPE_HANDLE 형식의 핸들을 반환합니다.

레지스트리에 대한 WDM 정보 가져오기

레지스트리에 대한 WDM 정보를 얻기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfRegistryWdmGetHandle
프레임워크 레지스트리 키 개체가 나타내는 레지스트리 키에 대한 WDM 핸들을 반환합니다.

파일 개체에 대한 WDM 정보 가져오기

파일 개체에 대한 WDM 정보를 가져오기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.

WdfFileObjectWdmGetFileObject
지정된 프레임워크 파일 개체와 연결된 WDM FILE_OBJECT 구조를 반환합니다.