次の方法で共有

ハードウェア通知クライアント ドライバーの作成

  • [アーティクル]

このセクションでは、Microsoft が提供する KMDF クラス拡張機能を利用するハードウェア通知クライアント ドライバーの開発に関する一般的なガイダンスを提供します。

  1. Mshwnclxstub.lib にリンクし、ヘッダー hwn.h と hwnclx.h をインクルードするクライアント ドライバー実装用のファイルを作成します。

  2. 必要な KMDF およびハードウェア通知クラス拡張機能コールバック関数のインスタンスを定義します。 具体的には、次のコード例に示すコールバック関数を実装して登録する必要があります。

    DRIVER_INITIALIZE DriverEntry;
EVT_WDF_DRIVER_DEVICE_ADD HwnClientEvtDeviceAdd;
HWN_CLIENT_INITIALIZE_DEVICE HwnClientInitializeDevice;
HWN_CLIENT_UNINITIALIZE_DEVICE HwnClientUnInitializeDevice;
HWN_CLIENT_QUERY_DEVICE_INFORMATION HwnClientQueryDeviceInformation;
HWN_CLIENT_START_DEVICE HwnClientStartDevice;
HWN_CLIENT_STOP_DEVICE HwnClientStopDevice;
HWN_CLIENT_SET_STATE HwnClientSetState;
HWN_CLIENT_GET_STATE HwnClientGetState;

  3. DriverEntry ルーチンを実装します。これは、クライアント ドライバーのエントリ ポイントであり、初期化を担当します。 ハードウェア通知クライアント ドライバーの場合、この関数は次の処理を行う必要があります。

  4. EVT_WDF_DRIVER_DEVICE_ADD 関数を実装します。この関数は、PnP マネージャーがデバイスの存在を報告するときにデバイスの初期化操作を実行する役割を担います。 ハードウェア通知クライアント ドライバーの場合、この関数は次の処理を行う必要があります。

    • HwNProcessAddDevicePreDeviceCreate を呼び出します。これは、KMDF がデバイスを別の状態に移行するために必要なデバイスの準備/リリース コールバックと開始/終了コールバックを提供します。

    • WdfDeviceCreate を呼び出してフレームワーク デバイス オブジェクトを作成します。

    • HwNProcessAddDevicePostDeviceCreate を呼び出して I/O キューを作成します。

  5. 定義済みの HWN_CLIENT_INITIALIZE_DEVICE 関数を実装します。この関数は、使用するハードウェア通知コントローラーを準備するためにクラス拡張機能によって呼び出されます。

  6. 定義済みの HWN_CLIENT_UNINITIALIZE_DEVICE 関数を実装します。この関数は、使用するハードウェア通知コントローラーを初期化するためにクラス拡張機能によって呼び出されます。

  7. 定義済みの HWN_CLIENT_QUERY_DEVICE_INFORMATION 関数を実装します。この関数は、クラス拡張機能によって呼び出されます。 この関数は、ハードウェア通知コンポーネントの属性を取得する役割を担います。

  8. 定義済みの HWN_CLIENT_START_DEVICE 関数を実装します。この関数は、クラス拡張機能によって呼び出されます。 この関数は、ハードウェア通知コントローラーを起動し、クライアント ドライバーの ACPI リソースを割り当てる役割を担います。

  9. 定義済みの HWN_CLIENT_STOP_DEVICE 関数を実装します。この関数は、クラス拡張機能によって呼び出されます。 この関数は、ハードウェア通知コントローラーを停止し、クライアント ドライバーが使用する ACPI リソースを解放する役割を担います。

  10. 定義済みの HWN_CLIENT_SET_STATE を実装します。この関数は、クラス拡張機能によって呼び出されます。 この関数は、ハードウェア通知コンポーネントの状態を設定する役割を担います。

  11. 定義済みの HWN_CLIENT_GET_STATE を実装します。この関数は、クラス拡張機能によって呼び出されます。 この関数は、ハードウェア通知コンポーネントの現在の値を取得する役割を担います。 入力バッファーが NULL の場合、つまりユーザーが特定のハードウェア通知状態を指定しなかった場合、この関数はすべてのハードウェア通知コンポーネントの状態情報を返します。

ハードウェア通知