次の方法で共有

SerCxInitialize 関数 (sercx.h)

  • [アーティクル]

SerCxInitialize メソッドは、このドライバーが関連付けられているデバイス オブジェクトを作成した後、シリアル フレームワーク拡張機能 (SerCx) の初期化を完了します。

構文

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

パラメーター

[in] FxDevice

シリアル コントローラーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。

[in] Config

SerCx の構成情報を含む呼び出し元によって割り当てられた SERCX_CONFIG 構造体へのポインター。 呼び出し元は以前、この構造体を初期化するために SERCX_CONFIG_INIT 関数を呼び出しました。

戻り値

SerCxInitialize 成功した場合、STATUS_SUCCESSが返されます。 考えられるエラー戻り値には、次の状態コードが含まれます。

リターン コード 形容
STATUS_INVALID_DEVICE_REQUEST
 メソッドが間違った IRQL で呼び出されました。または WDFDEVICE ハンドルが無効です。または、FxDevice または Config が NULL です。
STATUS_INSUFFICIENT_RESOURCES
 システム リソース (通常はメモリ) を割り当てませんでした。

備考

シリアル コントローラー ドライバーは、関連付けられているデバイス オブジェクトを作成した後、このメソッドを呼び出します。

SerCxInitialize は、コントローラー ドライバーの I/O コールバック関数を SerCx に登録します。 さらに、このメソッドは I/O キューの転送モードを定義します。 このメソッドは、呼び出し中に SerCx に必要なすべての内部構造を作成します (シリアル コントローラーの I/O キューを含む)。 このメソッドが戻った後、SerCx は I/O を処理する準備ができています。 ただし、コントローラー ドライバーは、EvtDriverDeviceAdd コールバックから戻る前、または PDO を子リストに追加する前に、コントローラー ハードウェア設定を構成する場合があります。

パラメーターが無効な場合 (SERCX_CONFIGで説明されているように)、ドライバー検証ツール エラーが発生します。

このルーチンは、デバイスをコミットする前に呼び出す必要があります (EvtDriverDeviceAdd から返すか、PDO を子リストに追加します)。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー sercx.h
IRQL PASSIVE_LEVEL

関連項目

EvtDriverDeviceAdd の

SERCX_CONFIG

SERCX_CONFIG_INIT