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」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | spbcx.h |
| Library | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |