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 へのポインター。

戻り値

なし

解説

レジストリには、ドライバーが 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
                            );

要件