IWDFIoQueue::RetrieveNextRequestByFileObject 메서드(wudfddi.h)

  • 아티클

경고

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

RetrieveNextRequestByFileObject 메서드는 파일 개체가 지정된 파일 개체와 일치하는 다음 I/O 요청을 I/O 큐에서 검색합니다.

구문

HRESULT RetrieveNextRequestByFileObject(
  [in]  IWDFFile      *pFile,
  [out] IWDFIoRequest **ppRequest
);

매개 변수

[in] pFile

파일 개체가 이 제공된 파일 개체와 일치하는 다음 I/O 요청을 검색하는 데 사용되는 파일 개체의 IWDFFile 인터페이스에 대한 포인터입니다.

[out] ppRequest

파일 개체가 제공된 파일 개체와 일치하는 다음 요청 개체에 대한 IWDFIoRequest 인터페이스에 대한 포인터를 수신하거나 큐가 비어 있거나 다음 요청을 찾을 수 없는 경우 NULL 을 수신하는 버퍼에 대한 포인터입니다.

반환 값

RetrieveNextRequestByFileObject 는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK 다음 I/O 요청이 I/O 큐에서 성공적으로 검색되었습니다.
HRESULT_FROM_NT(STATUS_WDF_PAUSED) 큐가 요청을 디스패치하지 않습니다. 이 상황은 디바이스가 전원 상태 전환을 거치고 모든 큐가 요청을 디스패치하는 것을 중지하거나 드라이버가 명시적으로 IWDFIoQueue::Stop을 호출하여 요청 디스패치를 중지하는 경우에 발생합니다. 이 상황은 드라이버가 전원이 관리되고 전원이 다운된 수동 큐에서 요청을 제거하려고 하거나 큐가 일시 중지된 경우에도 발생할 수 있습니다.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS) 큐에 요청이 없습니다.
HRESULT_FROM_NT(STATUS_INVALID_DEVICE_STATE) 병렬 큐에서 요청을 검색하기 위해 호출되었습니다.

RetrieveNextRequestByFileObject 는 다른 HRESULT 값도 반환할 수 있습니다.

설명

드라이버가 I/O 요청을 수동으로 디스패치하도록 I/O 큐를 구성하는 경우 드라이버는 RetrieveNextRequestByFileObject 메서드를 호출하여 파일 개체가 큐에서 제공된 파일 개체와 일치하는 다음 요청을 가져올 수 있습니다. I/O 요청을 수동으로 디스패치하는 방법에 대한 자세한 내용은 I/O 큐에 대한 디스패치 모드 구성을 참조하세요.

파일 개체가 pFile 매개 변수가 가리키는 파일 개체와 일치하는 여러 I/O 요청이 I/O 큐에 있으면 첫 번째 I/O 요청이 반환됩니다.

예제

RetrieveNextRequestByFileObject 메서드를 사용하는 방법에 대한 코드 예제는 IWDFIoQueue::RetrieveNextRequest를 참조하세요.

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보