WdfDeviceInitSetDeviceClass-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfDeviceInitSetDeviceClass- Methode gibt eine GUID an, die die Gerätesetupklasse des Gerätsidentifiziert.

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 Außerkraftsetzungen für die DefaultSDDLString, DeviceType, DeviceCharacteristicsund Exclusive Parameter 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 versuchen, anzugeben, dass vorhandene Klassen-GUID möglicherweise nicht installiert oder mit falschen Sicherheitseinstellungen installiert werden kann.

Rückgabewert

Nichts

Bemerkungen

Die Registrierung kann Werte enthalten, die die Werte überschreiben, die ein Treiber angibt, wenn er WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicsund WdfDeviceInitSetExclusive. 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 ein Steuerelementgeräterstellt wird.

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

Wenn ein Treiber WdfDeviceInitSetDeviceClassaufruft, muss er dies tun, bevor er WdfDeviceCreateaufruft.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

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-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Freigeben über