WDF_REQUEST_SEND_OPTIONS_FLAGS 열거형(wudfddi_types.h)

  • 아티클

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

WDF_REQUEST_SEND_OPTIONS_FLAGS 열거형 형식은 드라이버가 IWDFIoRequest::Send를 호출할 때 지정할 수 있는 플래그를 정의합니다.

Syntax

typedef enum _WDF_REQUEST_SEND_OPTIONS_FLAGS {
  WDF_REQUEST_SEND_OPTION_TIMEOUT,
  WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
  WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE,
  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET,
  WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT,
  WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
} WDF_REQUEST_SEND_OPTIONS_FLAGS;

상수

 
WDF_REQUEST_SEND_OPTION_TIMEOUT
설정된 경우 IWDFIoRequest::Send 메서드의 Timeout 매개 변수가 유효합니다.
WDF_REQUEST_SEND_OPTION_SYNCHRONOUS
설정된 경우 UMDF는 I/O 요청을 동기적으로 보냅니다.
WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE
설정된 경우 UMDF는 I/O 대상의 상태에 관계없이 I/O 요청을 I/O 대상으로 보냅니다. 설정되지 않은 경우 UMDF는 대상이 중지된 경우 요청을 큐에 대기합니다. 이 플래그를 설정하면 드라이버가 IWDFIoTargetStateManagement::Stop을 호출한 후 드라이버가 USB 파이프 재설정 요청과 같은 요청을 디바이스로 보낼 수 있습니다.
WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
설정된 경우 드라이버는 요청을 비동기적으로 전송하며 요청이 완료되거나 취소될 때 알림을 받을 필요가 없습니다. 드라이버는 요청에 대해 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수를 설정하거나 IWDFIoRequest::Complete 를 호출하지 않습니다. 이 플래그에 대한 자세한 내용은 다음 주의 섹션을 참조하세요.
WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT
설정되고 I/O 요청 형식이 WdfRequestCreate인 경우 Send 메서드는 클라이언트의 가장 수준을 드라이버의 I/O 대상에 전달하려고 시도합니다. 이 값은 UMDF 버전 1.9 이상에서 사용할 수 있습니다.
WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
설정된 경우 UMDF는 가장 실패를 무시합니다. 이 값은 WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT 경우에만 사용할 수 있습니다. 이 값은 UMDF 버전 1.9 이상에서 사용할 수 있습니다.

설명

WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET 플래그를 설정하는 드라이버는 일반적으로 IWDFIoRequest::Send 를 호출하여 I/O 대상에 요청을 보내기 전에 I/O 요청의 형식을 지정하지 않습니다. 실제로 이 플래그를 설정하는 드라이버는 IWDFIoRequest::Send를 호출하기 전에 IWdfIoTarget::FormatRequestForXxx 메서드를 호출해서는 안 됩니다. 드라이버는 IWDFIoRequest::FormatUsingCurrentType 메서드만 사용하여 요청의 형식을 지정할 수 있습니다.

IWDFIoRequest::Send의 pIoTarget 매개 변수가 파일 핸들 기반 I/O 대상 개체를 가리키는 경우 드라이버는 WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET 플래그를 설정할 수 없습니다. 이 유형의 I/O 대상에 대한 자세한 내용은 UMDF에서 일반 I/O 대상 초기화를 참조하세요.

드라이버가 WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET 플래그를 설정하는 경우 WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT 및 WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE 제외한 다른 플래그를 설정할 수 없습니다.

클라이언트 가장에 대한 자세한 내용은 클라이언트 가장 처리를 참조하세요.

이 열거형의 KMDF 버전은 WDF_REQUEST_SEND_OPTIONS_FLAGS 참조하세요.

요구 사항

요구 사항 값
최소 UMDF 버전 1.0
머리글 wudfddi_types.h(Wudfddi.h 포함)

추가 정보

IWDFIoRequest::Send