WdfDeviceInitSetDeviceClass-Funktion (wdfdevice.h)

[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.

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