WdfDeviceInitSetDeviceClass-Funktion (wdfdevice.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WdfDeviceInitSetDeviceClass-Methode gibt eine GUID an, die die Geräteeinrichtungsklasse des Geräts identifiziert.

Syntax

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

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] DeviceClassGuid

Zeiger auf eine GUID, die einen Abschnitt der Registrierung identifiziert, der mögliche Überschreibungen für die Parameter DefaultSDDLString, DeviceType, DeviceCharacteristics und Exclusive enthält.

Hinweis Sie sollten immer eine benutzerdefinierte Klassen-GUID angeben. Sie sollten keine vorhandene Klassen-GUID angeben. Wenn Sie eine vorhandene Klassen-GUID angeben, können andere Treiber, die angeben möchten, dass die vorhandene Klassen-GUID möglicherweise nicht installiert werden kann, oder möglicherweise mit falschen Sicherheitseinstellungen installiert werden.

Rückgabewert

Keine

Bemerkungen

Die Registrierung kann Werte enthalten, die die Werte überschreiben, die ein Treiber beim Aufrufen von WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics und WdfDeviceInitSetExclusive angibt. Der Treiber kann WdfDeviceInitSetDeviceClass aufrufen, um eine GUID anzugeben, die den Abschnitt der Registrierung identifiziert, der die Überschreibungswerte enthält.

In der Regel ruft ein Treiber WdfDeviceInitSetDeviceClass nur auf, wenn er ein Steuerungsgerät erstellt.

Weitere Informationen zur Verwendung der Registrierung finden Sie unter Festlegen von Geräteobjektregistrierungseigenschaften nach der Installation.

Wenn ein Treiber WdfDeviceInitSetDeviceClass aufruft, muss er dies tun, bevor er WdfDeviceCreate aufruft.

Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Beispiele

Im folgenden Codebeispiel wird die Setupklasse eines Geräts auf die Systemgeräteklasse festgelegt.

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

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Freigeben über