WdfDeviceInitSetDeviceClass 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfDeviceInitSetDeviceClass メソッドは、デバイスのデバイス セットアップ クラスを識別する GUID を指定します。

構文

void WdfDeviceInitSetDeviceClass(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

パラメーター

[in] DeviceInit

WDFDEVICE_INIT構造体へのポインター。

[in] DeviceClassGuid

DefaultSDDLString、DeviceType、DeviceCharacteristics、Exclusive パラメーターに対して可能なオーバーライドを含むレジストリのセクションを識別する GUID へのポインター。

メモ カスタム クラス GUID は常に指定する必要があります。 既存のクラス GUID は指定しないでください。 既存のクラス GUID を指定すると、既存のクラス GUID を指定しようとする他のドライバーがインストールに失敗したり、正しくないセキュリティ設定でインストールされたりする可能性があります。
 

戻り値

なし

解説

レジストリには、ドライバーが WdfDeviceInitAssignSDDLString、WdfDeviceInitSetDeviceType、WdfDeviceInitSetCharacteristics、および WdfDeviceInitSetExclusive を呼び出すときに指定する値をオーバーライドする値を含めることができます。 ドライバーは 、WdfDeviceInitSetDeviceClass を呼び出して、オーバーライド値を含むレジストリのセクションを識別する GUID を指定できます。

通常、ドライバーは、コントロール デバイスを作成する場合にのみ WdfDeviceInitSetDeviceClass を呼び出します。

レジストリの使用の詳細については、「 インストール後のデバイス オブジェクト レジストリプロパティの設定」を参照してください。

ドライバーが WdfDeviceInitSetDeviceClass を呼び出す場合は、 WdfDeviceCreate を呼び出す前に呼び出す必要があります。

WdfDeviceCreate の呼び出しの詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。

例

次のコード例では、デバイスのセットアップ クラスをシステム デバイス クラスに設定します。

DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 ChildDeviceInitAPI(kmdf)、 ControlDeviceInitAPI(kmdf)、 DeviceInitAPI(kmdf)、 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 PdoDeviceInitAPI(kmdf)