WdfRequestReuse 函式 (wdfrequest.h)

[適用於 KMDF 和 UMDF]

WdfRequestReuse 方法會重新初始化架構要求物件，以便重複使用它。

語法

NTSTATUS WdfRequestReuse(
  [in] WDFREQUEST                Request,
  [in] PWDF_REQUEST_REUSE_PARAMS ReuseParams
);

參數

[in] Request

架構要求物件的句柄。

[in] ReuseParams

呼叫端配置 WDF_REQUEST_REUSE_PARAMS 結構的指標。

傳回值

如果作業成功，WdfRequestReuse 會傳回STATUS_SUCCESS。 否則，這個方法可能會傳回下列其中一個值：

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

備註

架構型驅動程式可以重複使用先前呼叫 WdfRequestCreate 或 WdfRequestCreateFromIrp 所建立的架構要求物件。 驅動程式也可以重複使用 從架構收到的要求物件，但無法設定這些要求物件的 WDF_REQUEST_REUSE_SET_NEW_IRP 旗標。

驅動程式可以在原始要求完成之後重複使用要求物件。 在驅動程式呼叫 WdfRequestReuse 之後，要求的內容必須重新初始化。 驅動程式可以在 WDF_REQUEST_REUSE_PARAMS 結構中指定一些要求參數。

如果您想要重複使用的要求具有 CompletionRoutine 回呼函式，驅動程式必須在呼叫 WdfRequestSetCompletionRoutine 之後呼叫 WdfRequestReuse。

如需 WdfRequestReuse 的詳細資訊，請參閱 重複使用 Framework 要求物件。

範例

下列程式代碼範例是 CompletionRoutine 回呼函式的一部分，它會呼叫 WdfRequestReuse ，讓驅動程式可以重複使用驅動程式配置的要求。

VOID
MyRequestCompletionRoutine(
    IN WDFREQUEST  Request,
    IN WDFIOTARGET  Target,
    PWDF_REQUEST_COMPLETION_PARAMS  CompletionParams,
    IN WDFCONTEXT  Context
    )
{
    WDF_REQUEST_REUSE_PARAMS  params;
    NTSTATUS  status;
...
    WDF_REQUEST_REUSE_PARAMS_INIT(
                                  &params,
                                  WDF_REQUEST_REUSE_NO_FLAGS,
                                  STATUS_SUCCESS
                                  );

    status = WdfRequestReuse(
                             Request,
                             &params
                             );
    ASSERT(NT_SUCCESS(status));
...
}

規格需求

另請參閱

CompletionRoutine

WDF_REQUEST_REUSE_PARAMS

WDF_REQUEST_REUSE_PARAMS_INIT

WdfRequestCreate

WdfRequestCreateFromIrp

WdfRequestSetCompletionRoutine