WdfDeviceInitSetDeviceClass 函式 (wdfdevice.h)

  • 發行項

[僅適用於 KMDF]

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

語法

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

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] DeviceClassGuid

GUID 的指標，識別登錄區段，其中包含 DefaultSDDLString、DeviceType、DeviceCharacteristics 和 Exclusive 參數的可能覆寫。

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

傳回值

無

備註

登錄可以包含覆寫驅動程式呼叫 WdfDeviceInitAssignSDDLString、 WdfDeviceInitSetDeviceType、 WdfDeviceInitSetCharacteristics 和 WdfDeviceInitSetExclusive 時所指定值的值。 驅動程式可以呼叫 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)