共用方式為


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。 否則,這個方法可能會傳回下列其中一個值:

傳回碼 Description
STATUS_INVALID_PARAMETER
驅動程式提供了無效的句柄。
STATUS_NOT_FOUND
在 I/O 佇列中找不到 FoundRequest 參數所識別的要求。
STATUS_NO_MORE_ENTRIES
架構到達 I/O 佇列的結尾,但找不到符合搜尋準則的要求。
 

這個方法也可能傳回其他 NTSTATUS值

如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。

備註

呼叫 WdfIoQueueRetrieveFoundRequest 以取得 I/O 要求之後,驅動程式 會擁有 要求,而且必須以某種方式 處理 I/O 要求

在呼叫 WdfIoQueueRetrieveFoundRequest 之前,驅動程式必須呼叫 WdfIoQueueFindRequest,以擷取驅動程式可作為 WdfIoQueueRetrieveFoundRequest 的句柄。

如果您的驅動程式是以 KMDF 1.11 版或更新版本建置,驅動程式可以呼叫 WdfIoQueueRetrieveFoundRequest ,而不需要先呼叫 WdfIoQueueFindRequest。 在此情況下,驅動程式必須確定要求物件仍然有效,而且在佇列中。

如果 呼叫 WdfIoQueueRetrieveFoundRequest 傳回STATUS_NOT_FOUND,則佇列中先前的要求已經移除。 要求可能已取消。

如需 WdfIoQueueRetrieveFoundRequest 方法的詳細資訊,請參閱 管理 I/O 佇列

範例

如需使用 WdfIoQueueRetrieveFoundRequest 的程式代碼範例,請參閱 WdfIoQueueFindRequest

規格需求

需求
目標平台 Universal
最低 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, WdfIoQueueRetrieveFoundRequest (kmdf)

另請參閱

WdfIoQueueFindRequest

WdfIoQueueRetrieveNextRequest

WdfIoQueueRetrieveRequestByFileObject