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) |