共用方式為


WdfRequestGetCompletionParams 函式 (wdfrequest.h)

[適用於 KMDF 和 UMDF]

WdfRequestGetCompletionParams 方法會擷取與指定架構要求對象相關聯的 I/O 完成參數。

語法

void WdfRequestGetCompletionParams(
  [in]      WDFREQUEST                     Request,
  [in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);

參數

[in] Request

架構要求物件的句柄。

[in, out] Params

呼叫端提供的 WDF_REQUEST_COMPLETION_PARAMS 結構的指標。

傳回值

沒有

言論

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

在驅動程式呼叫 WdfRequestSend 以同步或異步方式將 I/O 要求傳送至 I/O 目標之後,並在 I/O 目標 完成 I/O 要求之後,驅動程式可以呼叫 WdfRequestGetCompletionParams,以取得 I/O 要求的完成參數。

只有在驅動程式藉由呼叫其中一個 WdfIoTargetFormatXxx 方法來格式化要求時,完成參數結構才會包含有效資訊。 例如,請參閱 WdfIoTargetFormatRequestForRead

請注意,如果您的驅動程式只會同步呼叫其中一個將 I/O 要求傳送至 I/O 目標的方法(例如 WdfIoTargetSendReadSynchronously),驅動程式必須 呼叫 WdfRequestGetCompletionParams

WdfRequestGetCompletionParams 方法會將 I/O 要求的完成參數複製到指定的 WDF_REQUEST_COMPLETION_PARAMS 結構中。

如果驅動程式以異步方式傳送 I/O 要求,通常會從 CompletionRoutine 回呼函式內呼叫此方法。

如需 WdfRequestGetCompletionParams的詳細資訊,請參閱 完成 I/O 要求

例子

下列程式代碼範例會初始化 WDF_REQUEST_COMPLETION_PARAMS 結構,然後呼叫 WdfRequestGetCompletionParams

WDF_REQUEST_COMPLETION_PARAMS completionParams;

WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
                              request,
                              &completionParams
                              );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfrequest.h (包括 Wdf.h)
連結庫 Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate(kmdf)InvalidReqAccess(kmdf)InvalidReqAccessLocal(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf)

另請參閱

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT