WdfIoQueueRetrieveFoundRequest 함수(wdfio.h)

[KMDF 및 UMDF에 적용]

WdfIoQueueRetrieveFoundRequest 메서드는 드라이버가 요청을 처리할 수 있도록 지정된 요청을 드라이버에 전달합니다.

구문

NTSTATUS WdfIoQueueRetrieveFoundRequest(
  [in]  WDFQUEUE   Queue,
  [in]  WDFREQUEST FoundRequest,
  [out] WDFREQUEST *OutRequest
);

매개 변수

[in] Queue

프레임워크 큐 개체에 대한 핸들입니다.

[in] FoundRequest

WdfIoQueueFindRequest를 호출하여 가져온 프레임워크 요청 개체에 대한 핸들입니다.

[out] OutRequest

프레임워크 요청 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다. 드라이버는 요청을 처리할 때 이 핸들을 사용해야 합니다.

반환 값

WdfIoQueueRetrieveFoundRequest 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
STATUS_INVALID_PARAMETER	드라이버가 잘못된 핸들을 제공했습니다.
STATUS_NOT_FOUND	FoundRequest 매개 변수로 식별되는 요청은 I/O 큐에서 찾을 수 없습니다.
STATUS_NO_MORE_ENTRIES	프레임워크가 검색 조건과 일치하는 요청을 찾지 않고 I/O 큐의 끝에 도달했습니다.

 

이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

I/O 요청을 얻기 위해 WdfIoQueueRetrieveFoundRequest 를 호출한 후 드라이버는 요청을 소유하고 어떤 방식으로 I/O 요청을 처리 해야 합니다.

WdfIoQueueRetrieveFoundRequest를 호출하기 전에 드라이버가 WdfIoQueueRetrieveFoundRequest에 대한 FoundRequest 매개 변수로 사용할 수 있는 핸들을 검색하는 WdfIoQueueFindRequest를 호출해야 합니다.

드라이버가 KMDF 버전 1.11 이상으로 빌드된 경우 드라이버는 먼저 WdfIoQueueFindRequest를 호출하지 않고 WdfIoQueueRetrieveFoundRequest를 호출할 수 있습니다. 이 경우 드라이버는 요청 개체가 여전히 유효하고 큐에 있는지 확인해야 합니다.

WdfIoQueueRetrieveFoundRequest에 대한 호출이 STATUS_NOT_FOUND 반환하면 이전에 큐에 있던 요청이 제거됩니다. 요청이 취소되었을 수 있습니다.

WdfIoQueueRetrieveFoundRequest 메서드에 대한 자세한 내용은 I/O 큐 관리를 참조하세요.

예제

WdfIoQueueRetrieveFoundRequest를 사용하는 코드 예제는 WdfIoQueueFindRequest를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfio.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DoubleCompletion(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), wdfioqueuefindrequestfailed, WdfIoQueueFindRequestFailed(kmdf), wdfioqueueretrievefoundrequest, WdfIoQueueRetrieveveFoundRequest(kmdf)

추가 정보

WdfIoQueueFindRequest

WdfIoQueueRetrieveNextRequest

WdfIoQueueRetrieveRequestByFileObject