このヘッダーは、LED や振動メカニズムなどの通知コンポーネントのハードウェアに依存しないサポートを提供するために必要なプログラミング インターフェイスを定義します。 このサポートは、クライアント ドライバーの迅速な開発を可能にするハードウェア通知コンポーネント専用の Kernel-Mode Driver Framework (KMDF) クラス拡張機能の導入によって提供されます。 KMDF クラス拡張機能は、基本的には、Windows ドライバー モデル (WDM) のポート ドライバーと同様に、特定のクラスのデバイスに対して定義された機能セットを提供する KMDF ドライバーです。 このセクションでは、ハードウェア通知クラス拡張機能のアーキテクチャの概要について説明します。 KMDF の詳細については、次を参照してください。
詳細については、以下を参照してください。
hwnclx.h には、次のプログラミング インターフェイスが含まれています。
関数
| HwNProcessAddDevicePostDeviceCreate の I/O キューを作成します。 クライアント ドライバーのEVT_WDF_DRIVER_DEVICE_ADDコールバック関数が呼び出され、デバイス オブジェクトが作成された後に呼び出す必要があります。 |
| HwNProcessAddDevicePreDeviceCreate の デバイスを別の状態に移行するために、デバイスの準備/リリースおよび開始/終了コールバックを Windows Driver Foundation (WDF) に提供します。 |
| HwNRegisterClient の ハードウェア通知クライアント ドライバーとそのコールバック関数をクラス拡張機能に登録します。 |
| HwNUnregisterClient の ハードウェア通知クライアント ドライバーとそのコールバック関数をクラス拡張機能で登録解除します。 この関数は、クライアント ドライバーがアンロードされるときに呼び出す必要があります。 |
コールバック関数
|
HWN_CLIENT_GET_STATE ハードウェア通知コンポーネントの状態を取得するためにクライアント ドライバーによって実装されます。 これは、ユーザーが状態情報を要求したときに呼び出されます。 |
|
HWN_CLIENT_INITIALIZE_DEVICE クライアント ドライバーによって実装され、EVT_WDF_DEVICE_PREPARE_HARDWAREの呼び出しの結果として呼び出されます。 |
|
HWN_CLIENT_QUERY_DEVICE_INFORMATION ハードウェア通知コンポーネント属性を取得するためにクライアント ドライバーによって実装されます。 |
|
HWN_CLIENT_SET_STATE ハードウェア通知コンポーネントの状態を設定するためにクライアント ドライバーによって実装されます。 ユーザーがドライバーの状態を変更する場合に呼び出されます。 |
|
HWN_CLIENT_START_DEVICE ハードウェア通知コンポーネントを開始するためにクライアント ドライバーによって実装されます。 EVT_WDF_DEVICE_D0_ENTRYの呼び出しの結果として呼び出されます。 |
|
HWN_CLIENT_STOP_DEVICE クライアント ドライバーによって実装され、ハードウェア通知コンポーネントを開始します。 これは、EVT_WDF_DEVICE_D0_EXITの呼び出しの結果として呼び出されます。 |
|
HWN_CLIENT_UNINITIALIZE_DEVICE クライアント ドライバーによって実装され、EVT_WDF_DEVICE_RELEASE_HARDWAREの呼び出しの結果として呼び出されます。 このコールバック関数は、ハードウェア通知コンポーネントを初期化解除します。 |
構造
|
CLIENT_DEVICE_INFORMATION CLIENT_DEVICE_INFORMATION構造体は、クライアント デバイス ドライバーが提供するハードウェア通知の合計数を返すために、ハードウェア通知コールバック HWN_CLIENT_QUERY_DEVICE_INFORMATIONによって使用されます。 |
|
HWN_CLIENT_REGISTRATION_PACKET クライアント ドライバーの登録時にクラス拡張機能に渡されるハードウェア通知クライアント ドライバー登録パケット。 バージョン情報とクライアント ドライバーコールバック関数が含まれています。 |
列挙型
|
HWN_CLX_EXPORT_INDEX エクスポート テーブル内の各ハードウェア通知エクスポートの位置を定義します。 |