WdfDeviceGetIoTarget 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceGetIoTarget 메서드는 지정된 디바이스에 대한 함수 또는 필터 드라이버의 로컬 I/O 대상에 대한 핸들을 반환합니다.

구문

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

작업이 성공하면 WdfDeviceGetIoTarget 은 프레임워크 I/O 대상 개체에 대한 핸들을 반환합니다. 지정된 프레임워크 디바이스 개체가 PDO를 나타내는 경우 메서드는 NULL을 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

UMDF 드라이버가 드라이버에서 만든 요청을 로컬 I/O 대상으로 보내면 요청에 연결된 파일 개체가 없습니다. HIDClass 열거형 원시 PDO와 같은 일부 하위 대상은 연결된 파일 개체가 없는 요청에 실패합니다. 이 경우 UMDF 드라이버는 WdfIoTargetOpenLocalTargetByFile 을 지정하여 파일 핸들을 사용하여 하위 스택(로컬 대상과 마찬가지로)을 나타내는 I/O 대상을 만들 수 있습니다. 따라서 이 I/O 대상에 전송된 드라이버 생성 요청은 열린 핸들에 해당하는 파일 개체와 연결됩니다.

이렇게 하려면 WdfIoTargetOpen을 호출하기 전에 WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 함수를 호출합니다.

I/O 대상에 대한 자세한 내용은 I/O 대상 사용을 참조하세요.

예제

다음 코드 예제에서는 지정된 디바이스의 로컬 I/O 대상에 대한 핸들을 가져옵니다.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)