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
                              );

規格需求

另請參閱

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT