Abrufen von WDM-Informationen

[Gilt nur für KMDF]

Das Framework stellt mehrere Objektmethoden bereit, mit denen Der Treiber WDM-definierte Informationen abrufen kann.

Abrufen von WDM-Informationen über den Treiber und seine Geräte

Um WDM-Informationen über einen Treiber und seine Geräte zu erhalten, kann der Treiber die folgenden Methoden aufrufen:

WdfFdoInitWdmGetPhysicalDevice
Ruft die DEVICE_OBJECT-Struktur ab, die das physische Geräteobjekt (PDO) eines Geräts darstellt. Ein Treiber kann diese Methode aufrufen, bevor der Treiber ein Framework-Geräteobjekt für das Gerät erstellt hat.

WdfDeviceWdmGetPhysicalDevice
Ruft die WDM-DEVICE_OBJECT-Struktur ab, die die PDO eines Geräts darstellt. Ein Treiber kann diese Methode aufrufen, nachdem er ein Framework-Geräteobjekt für das Gerät erstellt hat.

WdfDeviceWdmGetDeviceObject
Gibt das WDM-Geräteobjekt zurück, das einem angegebenen Frameworkgeräteobjekt zugeordnet ist.

WdfDeviceWdmGetAttachedDevice
Gibt das nächstniedrige WDM-Geräteobjekt im Gerätestapel zurück.

WdfWdmDeviceGetWdfDeviceHandle
Gibt ein Handle für das Framework-Geräteobjekt zurück, das einem angegebenen WDM-Geräteobjekt zugeordnet ist.

WdfWdmDriverGetWdfDriverHandle
Gibt ein Handle für das Frameworktreiberobjekt zurück, das einem angegebenen WDM-Treiberobjekt zugeordnet ist.

Abrufen von WDM-Informationen zu E/A-Anforderungen

Um WDM-Informationen zu E/A-Anforderungen zu erhalten, kann ein Treiber die folgenden Methoden aufrufen:

WdfRequestWdmGetIrp
Gibt die WDM-IRP-Struktur zurück, die einem angegebenen Frameworkanforderungsobjekt zugeordnet ist. (Andererseits kann ein Treiber, der ein WDM-IRP außerhalb des Frameworks empfängt, durch Aufrufen von WdfRequestCreateFromIrp ein Frameworkanforderungsobjekt für das IRP erstellen.)

WdfRequestGetParameters
Ruft die Parameter ab, die einem angegebenen Frameworkanforderungsobjekt zugeordnet sind. Die meisten dieser Parameter stammen aus dem SPEICHERORT des WDM-E/A-Stapels der Anforderung.)

WdfRequestRetrieveOutputWdmMdl
Ruft eine Speicherdeskriptorliste (Memory Descriptor List, MDL) ab, die den Ausgabepuffer einer E/A-Anforderung darstellt.

WdfRequestRetrieveInputWdmMdl
Ruft eine MDL ab, die den Eingabepuffer einer E/A-Anforderung darstellt.

WdfRequestFormatRequestUsingCurrentType
Kopiert den Inhalt des E/A-Stapelspeicherorts des aufrufenden Treibers in den E/A-Stapelspeicherort des lokalen E/A-Ziels des Treibers.

WdfRequestWdmFormatUsingStackLocation
Legt den Inhalt des E/A-Stapelspeicherorts für das lokale E/A-Ziel des Treibers fest.

Abrufen von WDM-Informationen zu E/A-Zielen

Um WDM-Informationen zu E/A-Zielen zu erhalten, kann ein Treiber die folgenden Methoden aufrufen:

WdfIoTargetWdmGetTargetDeviceObject
Gibt einen Zeiger auf das WDM-Geräteobjekt zurück, das einem lokalen oder Remote-E/A-Ziel zugeordnet ist.

WdfIoTargetWdmGetTargetFileObject
Gibt einen Zeiger auf die WDM-FILE_OBJECT-Struktur zurück, die einem Remote-E/A-Ziel zugeordnet ist.

WdfIoTargetWdmGetTargetFileHandle
Gibt ein Handle für die Datei zurück, die einem Remote-E/A-Ziel zugeordnet ist.

WdfIoTargetWdmGetTargetPhysicalDevice
Gibt einen Zeiger auf das WDM-Objekt (PDO) zurück, das das Gerät eines Remote-E/A-Ziels darstellt.

Abrufen von WDM-Informationen zu Interrupts und DPCs

Um WDM-Informationen zu Interrupts und verzögerten Prozeduraufrufen (DpCs) zu erhalten, kann ein Treiber die folgenden Methoden aufrufen:

WdfInterruptWdmGetInterrupt
Gibt einen Zeiger auf die WDM-KINTERRUPT-Struktur zurück, die einem angegebenen Framework-Interruptobjekt zugeordnet ist.

WdfDpcWdmGetDpc
Gibt einen Zeiger auf die WDM-KDPC-Struktur zurück, die einem angegebenen DPC-Frameworkobjekt zugeordnet ist.

Abrufen von WDM-Informationen zu USB-E/A-Zielen

Um WDM-Informationen zu USB-E/A-Zielen zu erhalten, kann ein Treiber die folgende Methode aufrufen:

WdfUsbTargetPipeWdmGetPipeHandle
Gibt das USBD_PIPE_HANDLE typisierte Handle zurück, das einem angegebenen Frameworkpipeobjekt zugeordnet ist.

Abrufen von WDM-Informationen zur Registrierung

Um WDM-Informationen über die Registrierung zu erhalten, kann ein Treiber die folgende Methode aufrufen:

WdfRegistryWdmGetHandle
Gibt ein WDM-Handle an den Registrierungsschlüssel zurück, den ein Framework-Registrierungsschlüsselobjekt darstellt.

Abrufen von WDM-Informationen zu Dateiobjekten

Um WDM-Informationen zu Dateiobjekten zu erhalten, kann ein Treiber die folgende Methode aufrufen:

WdfFileObjectWdmGetFileObject
Gibt die WDM-FILE_OBJECT-Struktur zurück, die einem angegebenen Frameworkdateiobjekt zugeordnet ist.