WDF_IO_TARGET_OPEN_TYPE 열거형(wdfiotarget.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

WDF_IO_TARGET_OPEN_TYPE 열거형은 드라이버가 WdfIoTargetOpen을 호출할 때 드라이버가 원격 I/O 대상을 식별하는 방법을 지정합니다.

Syntax

typedef enum _WDF_IO_TARGET_OPEN_TYPE {
  WdfIoTargetOpenUndefined = 0,
  WdfIoTargetOpenUseExistingDevice = 1,
  WdfIoTargetOpenByName = 2,
  WdfIoTargetOpenReopen = 3,
  WdfIoTargetOpenLocalTargetByFile = 4
} WDF_IO_TARGET_OPEN_TYPE;

상수


`WdfIoTargetOpenUndefined` 값: 0 시스템에서 사용하도록 예약되었습니다.
`WdfIoTargetOpenUseExistingDevice` 값: 1 이 값은 KMDF에서만 지원됩니다. 드라이버는 WDM(Windows 드라이버 모델) DEVICE_OBJECT 구조에 대한 포인터를 제공하여 원격 I/O 대상을 식별합니다.
`WdfIoTargetOpenByName` 값: 2 드라이버가 개체 이름을 나타내는 유니코드 이름 문자열을 제공하여 원격 I/O 대상을 열고 있습니다. 이 이름은 디바이스, 파일 또는 디바이스 인터페이스를 식별할 수 있습니다.
`WdfIoTargetOpenReopen` 값: 3 드라이버가 이전에 WdfIoTargetCloseForQueryRemove를 호출한 후 원격 I/O 대상을 다시 엽니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
`WdfIoTargetOpenLocalTargetByFile` 값: 4 이 값은 UMDF에서만 지원됩니다. Umdf 드라이버가 하위 스택(로컬 대상과 마찬가지로)을 나타내는 파일 핸들을 열고 있으므로 드라이버에서 만든 요청을 하위 스택으로 보낼 수 있습니다. UMDF 드라이버는 WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 호출할 때 이 값을 지정합니다.

설명

WDF_IO_TARGET_OPEN_TYPE 열거형은 WDF_IO_TARGET_OPEN_PARAMS 구조체의 Type 멤버에 사용됩니다.

드라이버는 원래 원격 I/O 대상을 열 때 WdfIoTargetOpenByName을 지정한 경우에만 WdfIoTargetOpenReopen을 지정할 수 있습니다.

WdfIoTargetOpenReopen이 설정된 경우 프레임워크는 WDF_IO_TARGET_OPEN_PARAMS 구조체의 다른 모든 멤버를 무시하고 원래 WdfIoTargetOpen을 호출할 때 드라이버가 지정한 값을 사용하여 원격 I/O 대상을 엽니다.

기본적으로 드라이버가 INF 파일에서 UmdfFileObjectPolicy=AllowNullAndUnknownFileObjects 를 지정하지 않는 한, UMDF는 파일 개체와 연결되지 않은 I/O 요청 처리를 허용하지 않습니다. 또한 HIDclass 열거 컬렉션 PDO와 같은 일부 드라이버 스택은 연결된 파일 개체가 없는 요청을 실패합니다.

앱에서 만든 요청과 달리 로컬 I/O 대상에 전송된 드라이버 생성 요청에는 연결된 파일 개체가 없습니다. 따라서 프레임워크 또는 하위 드라이버가 이러한 요청을 실패할 수 있습니다.

이 경우 WdfIoTargetOpenLocalTargetByFile 을 사용하여 로컬 대상으로 전송된 드라이버 생성 요청을 해당 대상에 해당하는 파일 개체와 연결할 수 있습니다.