IQueueCallbackRead::OnRead 메서드(wudfddi.h)

아티클
03/01/2024

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

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

구문

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

매개 변수

[in] pWdfQueue

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

[in] pWdfRequest

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

[in] NumOfBytesToRead

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

반환 값

없음

설명

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

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

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

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