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