다음을 통해 공유


IQueueCallbackWrite::OnWrite 메서드(wudfddi.h)

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

OnWrite 메서드는 애플리케이션이 Microsoft Win32 WriteFile 또는 WriteFileEx 함수를 통해 디바이스에 정보를 쓸 때 쓰기 요청을 처리하기 위해 호출됩니다.

통사론

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

매개 변수

[in] pWdfQueue

요청이 도착하는 I/O 큐 개체에 대한 IWDFIoQueue 인터페이스에 대한 포인터입니다.

[in] pWdfRequest

프레임워크 요청 개체를 나타내는 IWDFIoRequest 인터페이스에 대한 포인터입니다.

[in] NumOfBytesToWrite

요청에 대한 쓰기 버퍼의 크기(바이트)입니다.

반환 값

없음

발언

드라이버가 IWDFDevice::CreateIoQueue 메서드를 호출하여 I/O 큐를 만들거나 기본 I/O 큐를 구성할 때 드라이버는 IQueueCallbackWrite 인터페이스를 등록합니다.

드라이버는 모든 I/O 큐에 대해 단일 OnWrite 메서드를 구현하거나 각 I/O 큐에 대해 별도의 OnWrite 메서드를 구현할 수 있습니다.

OnWrite 메서드는 큐에서 모든 쓰기 요청 유형을 수신합니다. 쓰기 요청 형식은 요청에 대한 WDF_REQUEST_TYPE 열거형 형식의 WdfRequestWrite 값으로 식별됩니다. OnWrite 메서드는 수신된 각 쓰기 요청을 처리해야 합니다. UMDF 드라이버가 I/O 요청을 처리하는 방법에 대한 자세한 내용은 I/O 요청 처리참조하세요.

드라이버는 IWDFIoRequest::GetWriteParameters 호출하고 IWDFIoRequest::GetInputMemory 메서드를 요청 및 쓰기 버퍼에 대한 정보를 검색할 수 있습니다.

요구 사항

요구
대상 플랫폼 Windows
헤더 wudfddi.h(Wudfddi.h 포함)

참고 항목

IQueueCallbackWrite

IWDFDevice::CreateIoQueue

IWDFIoQueue

IWDFIoRequest

WDF_REQUEST_TYPE