다음을 통해 공유

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 다음 값 중 하나를 반환합니다.

반환 코드 묘사
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

참고 항목