コールバック オブジェクトの作成

  • [アーティクル]

警告

UMDF 2 は UMDF の最新バージョンであり、UMDF 1 に取って代わるものです。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。

アーカイブされた UMDF 1 サンプルは、Windows 11, バージョン 22H2 - 2022 年 5 月 ドライバー サンプル アップデートでご確認いただけます。

詳しくは、UMDFの概要をご覧ください。

UMDF ドライバーは、コンテキスト データとインターフェイス メソッドで構成されるコールバック オブジェクトを作成できます。 フレームワークは、ドライバーのコールバック インターフェイス メソッドを介してドライバーのコールバック オブジェクトにアクセスします。

次の図は、ドライバーによって実装されたコールバック オブジェクトがフレームワーク オブジェクトにどのように対応するかを示しています。

framework objects and vendor-supplied callback objects.

UMDF ドライバーは、次のようないくつかの種類のコールバック オブジェクトを作成できます。

  • ドライバー コールバック オブジェクト

    フレームワークは、ドライバー コールバック オブジェクトを使用してドライバーを初期化し、新しいデバイスの到着をドライバーに通知します。

  • デバイス コールバック オブジェクト

    ドライバーは、デバイス コールバック オブジェクトを使用して、デバイス コンテキストを格納し、ファイル オブジェクトとプラグ アンド プレイ (PnP) および電源管理 (PM) イベントのクリーンアップと終了を処理します。

  • キュー コールバック オブジェクト

    ドライバーは、キュー コールバック オブジェクトを使用して I/O を処理します。

次の図は、UMDF ドライバーがデバイス コールバック オブジェクトを作成する方法を示しています。

call sequence for creating a umdf device callback object.

次のトピックには、コールバック オブジェクトを作成する方法を示すコード例が含まれています。