WdfDeviceInitSetDeviceType-Funktion (wdfdevice.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WdfDeviceInitSetDeviceType-Methode legt den Gerätetyp für ein angegebenes Gerät fest.

Syntax

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] DeviceType

Ein FILE_DEVICE_XXXX Wert, der den Gerätetyp identifiziert. Weitere Informationen zu FILE_DEVICE_XXXX Werten finden Sie unter Angeben von Gerätetypen.

Rückgabewert

Keine

Bemerkungen

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

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

Der Gerätetyp, den ein Treiber angibt, bestimmt den Standardwert der Prioritätserhöhung, den das Framework verwendet, wenn der Treiber eine E/A-Anforderung abschließt. Weitere Informationen zu Prioritätssteigerungswerten finden Sie unter Angeben von Prioritätssteigerungen beim Abschließen von E/A-Anforderungen.

Wenn Sie einen UMDF-Treiber schreiben, müssen Sie die INF-Datei Ihres Treibers ändern oder Registrierungsänderungen vornehmen, um einen Gerätetyp anzugeben. Weitere Informationen zur Verwendung der Registrierung finden Sie unter Festlegen der Eigenschaften der Geräteobjektregistrierung während der Installation.

Beispiele

Das folgende Codebeispiel gibt an, dass es sich bei einem Gerät um ein serielles Gerät handelt.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

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), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Freigeben über