spbRequestGetParameters 函式 (spbcx.h)

SpbRequestGetParameters 方法會從 I/O 要求擷取一組 SPB 特定參數值。

語法

void SpbRequestGetParameters(
  [in]  SPBREQUEST             SpbRequest,
  [out] SPB_REQUEST_PARAMETERS *Parameters
);

參數

[in] SpbRequest

I/O 要求的 SPBREQUEST 句柄。 SPB 控制器驅動程式先前透過其中一個已註冊 的事件回呼函式收到此句柄。

[out] Parameters

呼叫端配置的 SPB_REQUEST_PARAMETERS 結構的指標，此方法會從 I/O 要求寫入 SPB 特定的參數值。 呼叫端先前必須藉由呼叫 SPB_REQUEST_PARAMETERS_INIT 函式來初始化此結構。

傳回值

無

備註

SpbRequestGetParameters 類似於 WdfRequestGetParameters 方法，但只會擷取 SPB 特定資訊。 SPB 控制器驅動程式可以呼叫 SpbRequestGetParameters ，從 SPB 架構擴充功能接收的 I/O 要求擷取 SPB 特定資訊， (SpbCx) 。 SPB 控制器驅動程式可以呼叫 WdfRequestGetParameters ，從接收的 I/O 要求擷取泛型要求參數。

範例

下列程式代碼範例示範如何使用 SpbRequestGetParameters 從 I/O 要求擷取 SPB 特定參數。 spbRequest 變數包含 I/O 要求的 SPBREQUEST 句柄。

SPB_REQUEST_PARAMETERS parameters;

SPB_REQUEST_PARAMETERS_INIT(&parameters);

SpbRequestGetParameters(spbRequest, &parameters);

規格需求

另請參閱

SPBREQUEST

SPB_REQUEST_PARAMETERS

SPB_REQUEST_PARAMETERS_INIT

WdfRequestGetParameters