WdfPdoInitAssignRawDevice-Funktion (wdfpdo.h)

[Gilt nur für KMDF]

Die WdfPdoInitAssignRawDevice-Methode gibt an, dass der aufrufende Treiber ein angegebenes Gerät im Rohmodus unterstützen kann.

Syntax

NTSTATUS WdfPdoInitAssignRawDevice(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] DeviceClassGuid

Ein Zeiger auf eine GUID, die eine Gerätesetupklasse identifiziert.

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 eine vorhandene Klassen-GUID möglicherweise nicht installiert werden kann, oder sie können mit falschen Sicherheitseinstellungen installiert werden.

Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode STATUS_SUCCESS zurück. Andernfalls wird STATUS_INVALID_PARAMETER zurückgegeben.

Hinweise

Der Treiber muss WdfPdoInitAssignRawDevice aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Die Registrierung kann Werte enthalten, die die Werte überschreiben, die ein Treiber beim Aufrufen von WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics und WdfDeviceInitSetExclusive angibt. Der DeviceClassGuid-Parameter der WdfPdoInitAssignRawDevice-Methode gibt eine GUID an, die den Abschnitt der Registrierung identifiziert, der die Außerkraftsetzungswerte enthält. Der Parameter DeviceClassGuid identifiziert nur einen Abschnitt der Registrierung und legt die Gerätesetupklasse für das Gerät nicht tatsächlich fest. Im Abschnitt INF-Version ihres Geräts und der INF-Datei ihres Treibers wird die Gerätesetupklasse festgelegt. In der Regel sollte die GUID des Parameters DeviceClassGuid mit der GUID übereinstimmen, die im Abschnitt INF-Version angegeben wird.

Weitere Informationen zur Verwendung der Registrierung finden Sie unter Festlegen der Eigenschaften der Geräteobjektregistrierung nach der Installation.

Beispiele

Der folgende Codeausschnitt aus dem kmdf_enumswitches Treiberbeispiel gibt an, dass ein Treiber das angegebene Gerät im Rohmodus unterstützen kann.

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

status = WdfPdoInitAssignRawDevice(
                                   pDeviceInit,
                                   &GUID_DEVCLASS_MYUNIQUEID
                                   );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfpdo.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL PASSIVE_LEVEL
DDI-Complianceregeln ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Weitere Informationen

WdfDeviceInitAssignSDDLString

WdfDeviceInitSetCharacteristics

WdfDeviceInitSetDeviceType

WdfDeviceInitSetExclusive