WdfDeviceInitSetDeviceType-Funktion (wdfdevice.h)

[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

Nichts

Bemerkungen

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

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

Der gerätetyp, den ein Treiber angibt, bestimmt den Standardprioritätsverstärkungswert, den das Framework verwendet, wenn der Treiber eine E/A-Anforderung abgeschlossen hat. Weitere Informationen zu Prioritätsverstärkungswerten finden Sie unter Angeben von Prioritätsverstärkungen beim Abschließen von E/A-Anforderungen.

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

Beispiele

Im folgenden Codebeispiel wird angegeben, dass ein Gerät ein serielles Gerät ist.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

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