UMDF_VERSION_DATA構造体 (wudfddi_types.h)

  • [アーティクル]

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

UMDF_VERSION_DATA構造では、フレームワークのバージョンについて説明します。

構文

typedef struct UMDF_VERSION_DATA {
  ULONG MajorNumber;
  ULONG MinorNumber;
  ULONG ServiceNumber;
} UMDF_VERSION_DATA, *PUMDF_VERSION_DATA;

メンバー

MajorNumber

フレームワークのメジャー バージョンを指定する数値。

MinorNumber

フレームワークのマイナー バージョンを指定する数値。

ServiceNumber

フレームワークのサービスを指定する数値。

注釈

UMDF ドライバーは、 ドライバー がサポートするフレームワークの最小バージョンを記述するために、 IWDFDriver::IsVersionAvailable メソッドにUMDF_VERSION_DATA構造体へのポインターを提供します。

注 警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。
 

Microsoft_WDF_UMDF_Version は、フレームワークの現在のリリースのメジャー バージョン、マイナー バージョン、およびサービス番号を 指定する UMDF_VERSION_DATA 型のグローバル変数です。

たとえば、Windows 8では、Wudfddi.h は次を指定します。

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Wudfddi.h を使用してドライバーをコンパイルすると、 Microsoft_WDF_UMDF_Version がドライバー バイナリに含まれ、 __declspec(dllexport)を使用してエクスポートされます。

システムによってドライバーが読み込まれると、ホスト プロセス (WUDFHost.exe) は、ドライバーのメジャー バージョンがフレームワークのメジャー バージョンと一致し、ドライバーのマイナー バージョンがフレームワークのマイナー バージョン以下であることを確認します。

ドライバーは、Wudfddi.h でビルドする以外に、このバージョン番号をフレームワークに提供するためのアクションを実行する必要はありません。

サポート終了: UMDF 2.0 以降では使用できません。

UMDF の最小バージョン: 1.0

ヘッダー: Wudfddi.h (Wudfddi.h を含む)

要件

要件 値
Header wudfddi_types.h (Wudfddi_types.h を含む)

こちらもご覧ください

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version