spbDeviceInitialize 函式 (spbcx.h)

SpbDeviceInitialize 方法會在此驅動程式建立相關聯的裝置對象之後完成 SPB 控制器驅動程式的初始化。

語法

NTSTATUS SpbDeviceInitialize(
  [in] WDFDEVICE              FxDevice,
  [in] PSPB_CONTROLLER_CONFIG Config
);

[in] FxDevice

代表SPB控制器之裝置物件的WDFDEVICE句柄。

[in] Config

SPB_CONTROLLER_CONFIG 結構的指標，其中包含SPB控制器驅動程式的裝置組態資訊。這個結構必須由 SPB_CONTROLLER_CONFIG_INIT 函式初始化。

SpbDeviceInitialize 會在成功時傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS錯誤碼。

SPB 控制器驅動程式會呼叫此方法，以SPB架構擴充功能註冊其事件回呼函式， (SpbCx) ，並指定要用於控制器 I/O 佇列的傳輸模式。 SpbDeviceInitialize 會建立控制器的所有內部數據結構，包括 I/O 佇列。

SPB 控制器驅動程式必須先呼叫這個方法，才能認可裝置物件，也就是從 EvtDriverDeviceAdd 回呼傳回之前，或將 PDO 新增至控制器的子清單。子清單代表連接至總線的裝置。如需詳細資訊，請參閱列舉總線上的裝置。

SpbDeviceInitialize 傳回之後，控制器便準備好處理 I/O 要求，但 SPB 控制器驅動程式可以視需要繼續設定控制器設定，再認可裝置物件。

如果 Config 所指向的結構未正確填寫，驅動程式驗證程式將會引發錯誤。如需 Config 參數需求的詳細資訊，請參閱 SPB_CONTROLLER_CONFIG。