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。