共用方式為


WdfDeviceInitSetDeviceClass 函式 (wdfdevice.h)

[僅適用於 KMDF]

WdfDeviceInitSetDeviceClass 方法會指定 GUID 來識別裝置的裝置設定類別

語法

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

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] DeviceClassGuid

GUID 的指標,識別登錄區段,其中包含 DefaultSDDLStringDeviceType、DeviceCharacteristicsExclusive 參數的可能覆寫。

注意 您應該一律指定自定義類別 GUID。 您不應該指定現有的類別 GUID。 如果您指定現有的類別 GUID,其他嘗試指定現有類別 GUID 的驅動程式可能無法安裝,或可能會安裝不正確的安全性設定。
 

傳回值

備註

登錄可以包含覆寫驅動程式呼叫 WdfDeviceInitAssignSDDLStringWdfDeviceInitSetDeviceTypeWdfDeviceInitSetCharacteristicsWdfDeviceInitSetExclusive 時所指定值的值。 驅動程式可以呼叫 WdfDeviceInitSetDeviceClass 來指定 GUID,以識別包含覆寫值的登錄區段。

一般而言,驅動程式只會在建立控制裝置時呼叫 WdfDeviceInitSetDeviceClass

如需使用登錄的詳細資訊,請參閱 安裝後設定裝置物件登錄屬性

如果驅動程式呼叫 WdfDeviceInitSetDeviceClass,它必須先這麼做,才能呼叫 WdfDeviceCreate

如需呼叫 WdfDeviceCreate 的詳細資訊,請參閱 建立 Framework 裝置物件

範例

下列程式代碼範例會將裝置的設定類別設定為系統裝置類別。

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

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 ChildDeviceInitAPI (kmdf) ControlDeviceInitAPI (kmdf) DeviceInitAPI (kmdf) DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf ) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf)