SpbDeviceInitialize 関数 (spbcx.h)

SpbDeviceInitialize メソッドは、このドライバーが関連付けられているデバイス オブジェクトを作成した後、SPB コントローラー ドライバーの初期化を完了します。

構文

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

パラメーター

[in] FxDevice

SPB コントローラーを表すデバイス オブジェクトへの WDFDEVICE ハンドル。

[in] Config

SPB コントローラー ドライバーのデバイス構成情報を含む SPB_CONTROLLER_CONFIG 構造体へのポインター。 この構造体は 、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」を参照してください。

要件

こちらもご覧ください

EvtChildListCreateDevice

EvtDriverDeviceAdd

SPB_CONTROLLER_CONFIG

SPB_CONTROLLER_CONFIG_INIT