hwnclx.h ヘッダー

このヘッダーは、LED や振動メカニズムなどの通知コンポーネントのハードウェアに依存しないサポートを提供するために必要なプログラミング インターフェイスを定義します。 このサポートは、クライアント ドライバーの迅速な開発を可能にするハードウェア通知コンポーネント専用のカーネルモード ドライバー フレームワーク (KMDF) クラスの拡張を導入することで提供されます。 KMDF クラスの拡張は、本質的には、特定のクラスのデバイス用に定義された機能セットを提供する KMDF ドライバーであり、Windows Driver Model (WDM) 内のポート ドライバーと同様です。 このセクションでは、ハードウェア通知クラスの拡張のアーキテクチャの概要を示します。 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 エクスポート テーブル内の各ハードウェア通知エクスポートの位置を定義します。