WDF_REQUEST_TYPE 열거형(wudfddi_types.h)

아티클
03/01/2024

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

WDF_REQUEST_TYPE 열거형은 UMDF 요청 개체가 나타낼 수 있는 I/O 요청 유형을 식별합니다.

Syntax

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

상수


`WdfRequestUndefined` 요청 개체의 형식이 정의되지 않았습니다.
`WdfRequestCreate` 요청 개체는 파일 만들기 요청을 나타냅니다. 애플리케이션이 Microsoft Win32 CreateFile 함수를 호출하여 디바이스를 열 때 드라이버는 이러한 유형의 요청 개체를 받습니다. 프레임워크는 새로 만든 파일 개체(IWDFFile)와 함께 이러한 유형의 요청을 드라이버의 IQueueCallbackCreate::OnCreateFile 콜백 함수에 전달합니다. 새 파일 개체는 Win32 CreateFile 이 반환하는 HANDLE 형식의 파일 핸들을 나타냅니다.
`WdfRequestCleanup` 요청 개체는 파일 정리 요청을 나타냅니다. 드라이버는 Win32 CloseHandle 함수에 대한 애플리케이션의 호출이 파일 개체에 대한 마지막 핸들을 닫은 후 파일의 미해결 I/O 요청이 모두 완료되거나 취소되기 전에 이러한 유형의 요청 개체를 받습니다. 프레임워크는 드라이버의 IFileCallbackCleanup::OnCleanupFile 콜백 함수에 이러한 유형의 요청을 전달합니다. ( WdfRequestClose도 참조하세요.)
`WdfRequestRead` 요청 개체는 읽기 요청을 나타냅니다. 이 드라이버는 애플리케이션이 Win32 ReadFile 또는 ReadFileEx 함수를 호출할 때 이러한 유형의 I/O 요청을 받습니다. 프레임워크는 드라이버의 IQueueCallbackRead::OnRead 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestWrite` 요청 개체는 쓰기 요청을 나타냅니다. 이 드라이버는 애플리케이션이 Win32 WriteFile 또는 WriteFileEx 함수를 호출할 때 이러한 유형의 I/O 요청을 받습니다. 프레임워크는 드라이버의 IQueueCallbackWrite::OnWrite 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestDeviceIoControl` 요청 개체는 디바이스 I/O 제어 요청을 나타냅니다. 이 드라이버는 애플리케이션이 Win32 DeviceIoControl 함수를 호출할 때 이러한 유형의 I/O 요청을 받습니다. 프레임워크는 드라이버의 IQueueCallbackDeviceIoControl::OnDeviceIoControl 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestClose` 요청 개체는 파일 닫기 요청을 나타냅니다. 드라이버는 Win32 CloseHandle 함수에 대한 애플리케이션의 호출이 파일 개체에 대한 마지막 핸들을 닫고 파일의 미해결 I/O 요청이 모두 완료되거나 취소된 후 이러한 유형의 요청 개체를 받습니다. 프레임워크는 드라이버의 IFileCallbackClose::OnCloseFile 콜백 함수에 이러한 유형의 요청을 전달합니다. ( WdfRequestCleanup도 참조하세요.)
`WdfRequestUsb` 요청 개체가 USB 포트로 전송되었습니다. IWDFRequestCompletionParams::GetCompletedRequestType 메서드는 이 값을 반환할 수 있습니다.
`WdfRequestOther` 이 값은 내부 전용으로 예약되어 있습니다.
`WdfRequestInternalIoctl` 이 값은 내부 전용으로 예약되어 있습니다.
`WdfRequestTypeNoFormat` 요청 개체의 형식이 지정되지 않았습니다.
`WdfRequestFlushBuffers` 요청 개체는 캐시된 버퍼를 플러시하는 요청을 나타냅니다. 프레임워크는 드라이버의 IQueueCallbackDefaultIoHandler::OnDefaultIoHandler 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestQueryInformation` 요청 개체는 파일에 대한 정보를 가져오는 요청을 나타냅니다. 프레임워크는 드라이버의 IQueueCallbackDefaultIoHandler::OnDefaultIoHandler 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestSetInformation` 요청 개체는 파일에 대한 정보를 설정하는 요청을 나타냅니다. 프레임워크는 드라이버의 IQueueCallbackDefaultIoHandler::OnDefaultIoHandler 콜백 함수에 이러한 유형의 요청을 전달합니다.
`WdfRequestMaximum` 열거형의 최대값을 초과합니다.