wdfrequest.h-Header

Dieser Header wird von wdf verwendet. Weitere Informationen finden Sie unter:

• Windows Driver Framework-

wdfrequest.h enthält die folgenden Programmierschnittstellen:

Funktionen

WDF_REQUEST_COMPLETION_PARAMS_INIT Die WDF_REQUEST_COMPLETION_PARAMS_INIT-Funktion initialisiert eine WDF_REQUEST_COMPLETION_PARAMS Struktur.
WDF_REQUEST_FORWARD_OPTIONS_INIT Die WDF_REQUEST_FORWARD_OPTIONS_INIT-Funktion initialisiert eine WDF_REQUEST_FORWARD_OPTIONS Struktur.
WDF_REQUEST_PARAMETERS_INIT Die WDF_REQUEST_PARAMETERS_INIT-Funktion initialisiert eine WDF_REQUEST_PARAMETERS Struktur.
WDF_REQUEST_REUSE_PARAMS_INIT Die WDF_REQUEST_REUSE_PARAMS_INIT-Funktion initialisiert die WDF_REQUEST_REUSE_PARAMS Struktur eines Treibers.
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP Die WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP-Funktion legt ein neues IRP in der WDF_REQUEST_REUSE_PARAMS Struktur eines Treibers fest.
WDF_REQUEST_SEND_OPTIONS_INIT Die WDF_REQUEST_SEND_OPTIONS_INIT-Funktion initialisiert die WDF_REQUEST_SEND_OPTIONS Struktur eines Treibers.
WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT Die WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion legt einen Timeoutwert in der WDF_REQUEST_SEND_OPTIONS Struktur eines Treibers fest.
WdfRequestAllocateTimer- Die WdfRequestAllocateTimer-Methode weist einen Timer für eine angegebene E/A-Anforderung zu.
WdfRequestCancelSentRequest Die WdfRequestCancelSentRequest-Methode versucht, eine E/A-Anforderung abzubrechen, die der Aufrufer zuvor an ein E/A-Ziel übermittelt hat.
WdfRequestChangeTarget- Die WdfRequestChangeTarget-Methode überprüft, ob eine angegebene E/A-Anforderung an ein angegebenes E/A-Ziel gesendet werden kann.
WdfRequestComplete- Die WdfRequestComplete-Methode schließt eine angegebene E/A-Anforderung ab und stellt einen Abschlussstatus zur Folge.
WdfRequestCompleteWithInformation- Die WdfRequestCompleteWithInformation-Methode speichert Abschlussinformationen und schließt dann eine angegebene E/A-Anforderung mit einem angegebenen Abschlussstatus ab.
WdfRequestCompleteWithPriorityBoost Die WdfRequestCompleteWithPriorityBoost-Methode schließt eine angegebene E/A-Anforderung ab und stellt einen Abschlussstatus bereit. Außerdem wird ein Wert angegeben, den das System verwenden kann, um die Laufzeitpriorität des Threads zu erhöhen, der den E/A-Vorgang angefordert hat.
WdfRequestCreate Die WdfRequestCreate-Methode erstellt ein leeres Framework-Anforderungsobjekt.
WdfRequestCreateFromIrp Die WdfRequestCreateFromIrp-Methode erstellt ein Framework-Anforderungsobjekt aus einem angegebenen WDM-IRP.
WdfRequestFormatRequestUsingCurrentType Die WdfRequestFormatRequestUsingCurrentType-Methode formatiert eine angegebene E/A-Anforderung, sodass der Treiber sie, unverändert, an das lokale E/A-Ziel des Treibers weiterleiten kann.
WdfRequestForwardToIoQueue Die WdfRequestForwardToIoQueue-Methode stellt eine E/A-Anforderung in eine der E/A-Warteschlangen des aufrufenden Treibers um.
WdfRequestForwardToParentDeviceIoQueue Die WdfRequestForwardToParentDeviceIoQueue-Methode stellt eine E/A-Anforderung aus der E/A-Warteschlange eines untergeordneten Geräts in eine angegebene E/A-Warteschlange des übergeordneten Geräts des untergeordneten Geräts zurück.
WdfRequestGetCompletionParams Die WdfRequestGetCompletionParams-Methode ruft die E/A-Abschlussparameter ab, die einem angegebenen Framework-Anforderungsobjekt zugeordnet sind.
WdfRequestGetEffectiveIoType Die WdfRequestGetEffectiveIoType-Methode gibt die Pufferzugriffsmethode zurück, die UMDF für die Datenpuffer der angegebenen E/A-Anforderung verwendet.
WdfRequestGetFileObject- Die WdfRequestGetFileObject-Methode ruft das Frameworkdateiobjekt ab, das einer angegebenen E/A-Anforderung zugeordnet ist.
WdfRequestGetInformation- Die WdfRequestGetInformation-Methode gibt Abschlussstatusinformationen für eine angegebene E/A-Anforderung zurück.
WdfRequestGetIoQueue Die WdfRequestGetIoQueue-Methode gibt ein Handle an das Framework-Warteschlangenobjekt zurück, aus dem eine angegebene E/A-Anforderung übermittelt wurde.
WdfRequestGetParameters Die WdfRequestGetParameters-Methode ruft die Parameter ab, die einem angegebenen Framework-Anforderungsobjekt zugeordnet sind.
WdfRequestGetRequestorMode- Die WdfRequestGetRequestorMode-Methode gibt den Prozessorzugriffsmodus des Absenders einer angegebenen E/A-Anforderung zurück.
WdfRequestGetRequestorProcessId- Die WdfRequestGetRequestorProcessId-Methode ruft den Bezeichner des Prozesses ab, der eine E/A-Anforderung gesendet hat.
WdfRequestGetStatus- Die WdfRequestGetStatus-Methode gibt den Status einer E/A-Anforderung zurück.
WdfRequestGetUserModeDriverInitiatedIo Die WdfRequestGetUserModeDriverInitiatedIo-Methode bestimmt, ob eine E/A-Anforderung durch einen UMDF-Treiber initiiert wird.
WdfRequestImpersonate Die WdfRequestImpersonate-Methode registriert eine vom Treiber bereitgestellte Ereignisrückruffunktion, die das Framework für den Identitätswechsel aufrufen soll.
WdfRequestIsCanceled Die WdfRequestIsCanceled-Methode bestimmt, ob der E/A-Manager versucht hat, eine angegebene E/A-Anforderung abzubrechen.
WdfRequestIsFrom32BitProcess- Die WdfRequestIsFrom32BitProcess-Methode überprüft, ob der Absender einer angegebenen E/A-Anforderung eine 32-Bit-Benutzermodusanwendung ist.
WdfRequestIsFromUserModeDriver Die WdfRequestIsFromUserModeDriver-Methode gibt an, ob eine E/A-Anforderung von einem Benutzermodustreiber oder einer Anwendung stammt.
WdfRequestIsReserved- Die WdfRequestIsReserved-Methode bestimmt, ob ein angegebenes Anforderungsobjekt einer ist, der vom Framework reserviert ist, um den garantierten Vorwärtsfortschritt in Situationen mit geringem Arbeitsspeicher zu unterstützen.
WdfRequestMarkCancelable Die WdfRequestMarkCancelable-Methode ermöglicht den Abbruch einer angegebenen E/A-Anforderung.
WdfRequestMarkCancelableEx- Die WdfRequestMarkCancelableEx-Methode ermöglicht das Abbrechen einer angegebenen E/A-Anforderung.
WdfRequestProbeAndLockUserBufferForRead Die WdfRequestProbeAndLockUserBufferForRead-Methode überprüft, ob der Benutzermoduspuffer einer E/A-Anforderung lesbar ist, und sperrt dann die physischen Speicherseiten des Puffers, sodass Treiber im Treiberstapel den Puffer lesen können.
WdfRequestProbeAndLockUserBufferForWrite Die WdfRequestProbeAndLockUserBufferForWrite-Methode überprüft, ob der Benutzermoduspuffer einer E/A-Anforderung schreibgeschützt ist, und sperrt dann die physischen Speicherseiten des Puffers, sodass Treiber im Treiberstapel in den Puffer schreiben können.
WdfRequestRequeue Die WdfRequestRequeue-Methode gibt eine E/A-Anforderung an den Kopf der E/A-Warteschlange zurück, von der sie an den Treiber übermittelt wurde.
WdfRequestRetrieveActivityId Die WdfRequestRetrieveActivityId-Methode ruft den aktuellen Aktivitätsbezeichner ab, der einer E/A-Anforderung zugeordnet ist.
WdfRequestRetrieveInputBuffer Die WdfRequestRetrieveInputBuffer-Methode ruft den Eingabepuffer einer E/A-Anforderung ab.
WdfRequestRetrieveInputMemory Die WdfRequestRetrieveInputMemory-Methode ruft ein Handle für ein Framework-Speicherobjekt ab, das den Eingabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveInputWdmMdl Die WdfRequestRetrieveInputWdmMdl-Methode ruft eine Speicherdeskriptorliste (MDL) ab, die den Eingabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveOutputBuffer Die WdfRequestRetrieveOutputBuffer-Methode ruft den Ausgabepuffer einer E/A-Anforderung ab.
WdfRequestRetrieveOutputMemory Die WdfRequestRetrieveOutputMemory-Methode ruft ein Handle zu einem Framework-Speicherobjekt ab, das den Ausgabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveOutputWdmMdl Die WdfRequestRetrieveOutputWdmMdl-Methode ruft eine Speicherdeskriptorliste (MDL) ab, die den Ausgabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveUnsafeUserInputBuffer Die WdfRequestRetrieveUnsafeUserInputBuffer-Methode ruft den Eingabepuffer einer E/A-Anforderung ab, wenn die Technik der Anforderung für den Zugriff auf Datenpuffer weder gepuffert noch direkte E/A ist.
WdfRequestRetrieveUnsafeUserOutputBuffer Die WdfRequestRetrieveUnsafeUserOutputBuffer-Methode ruft den Ausgabepuffer einer E/A-Anforderung ab, wenn die Technik der Anforderung für den Zugriff auf Datenpuffer weder gepuffert noch direkte E/A ist.
WdfRequestReuse- Mit der WdfRequestReuse-Methode wird ein Framework-Anforderungsobjekt erneut initialisiert, sodass es wiederverwendet werden kann.
WdfRequestSend- Die WdfRequestSend-Methode sendet eine angegebene E/A-Anforderung an ein angegebenes E/A-Ziel.
WdfRequestSetActivityId Die WdfRequestSetActivityId-Methode ordnet einen Aktivitätsbezeichner einer E/A-Anforderung zu.
WdfRequestSetCompletionRoutine- Die WdfRequestSetCompletionRoutine-Methode registriert oder deregistert eine Abschlussroutine für das angegebene Framework-Anforderungsobjekt.
WdfRequestSetInformation- Die WdfRequestSetInformation-Methode legt Abschlussstatusinformationen für eine angegebene E/A-Anforderung fest.
WdfRequestSetUserModeDriverInitiatedIo Die WdfRequestSetUserModeDriverInitiatedIo-Methode gibt an, dass kernelmodustreiber, die sich unterhalb des UMDF-Treibers im selben Gerätestapel befinden, als ob eine bestimmte Anforderung von einem UMDF-Treiber behandelt werden sollte.
WdfRequestStopAcknowledge Die WdfRequestStopAcknowledge-Methode informiert das Framework, dass der Treiber die Verarbeitung einer angegebenen E/A-Anforderung beendet hat.
WdfRequestUnmarkCancelable Die WdfRequestUnmarkCancelable-Methode deaktiviert den Abbruch einer angegebenen E/A-Anforderung.
WdfRequestWdmFormatUsingStackLocation Die WdfRequestWdmFormatUsingStackLocation-Methode formatiert eine E/A-Anforderung, indem der Inhalt einer angegebenen WDM-I/O-Stapelpositionsstruktur in die nächste Stapelposition in der Anforderung kopiert wird.
WdfRequestWdmGetIrp Die WdfRequestWdmGetIrp-Methode gibt die WDM-IRP-Struktur zurück, die einem angegebenen Framework-Anforderungsobjekt zugeordnet ist.

Rückruffunktionen

EVT_WDF_REQUEST_CANCEL Die EvtRequestCancel-Ereignisrückruffunktion eines Treibers verarbeitet Vorgänge, die ausgeführt werden müssen, wenn eine E/A-Anforderung abgebrochen wird.
EVT_WDF_REQUEST_COMPLETION_ROUTINE Die CompletionRoutine-Ereignisrückruffunktion eines Treibers wird ausgeführt, wenn ein anderer Treiber eine angegebene E/A-Anforderung abgeschlossen hat.
EVT_WDF_REQUEST_IMPERSONATE Die EvtRequestImpersonate-Ereignisrückruffunktion eines Treibers führt Aufgaben auf der angeforderten Identitätswechselebene aus, z. B. das Öffnen einer geschützten Datei.

Strukturen

WDF_REQUEST_COMPLETION_PARAMS Die WDF_REQUEST_COMPLETION_PARAMS Struktur enthält Parameter, die dem Abschluss einer E/A-Anforderung zugeordnet sind.
WDF_REQUEST_FORWARD_OPTIONS Die WDF_REQUEST_FORWARD_OPTIONS-Struktur enthält Optionen zum Erneuten Abrufen einer E/A-Anforderung aus der E/A-Warteschlange eines untergeordneten Geräts in die E/A-Warteschlange des übergeordneten Geräts.
WDF_REQUEST_PARAMETERS Die WDF_REQUEST_PARAMETERS Struktur empfängt Parameter, die einer E/A-Anforderung zugeordnet sind.
WDF_REQUEST_REUSE_PARAMS Die WDF_REQUEST_REUSE_PARAMS Struktur gibt Informationen an, die einer wiederverwendeten E/A-Anforderung zugeordnet sind.
WDF_REQUEST_SEND_OPTIONS Die WDF_REQUEST_SEND_OPTIONS Struktur gibt Optionen an, die dem Senden einer E/A-Anforderung an ein E/A-Ziel zugeordnet sind.

Enumerationen

WDF_REQUEST_FORWARD_OPTIONS_FLAGS Der WDF_REQUEST_FORWARD_OPTIONS_FLAGS Enumerationstyp definiert Flags, die in der WDF_REQUEST_FORWARD_OPTIONS Struktur eines Treibers verwendet werden.
WDF_REQUEST_REUSE_FLAGS Der WDF_REQUEST_REUSE_FLAGS Enumerationstyp definiert Flags, die in der WDF_REQUEST_REUSE_PARAMS Struktur eines Treibers verwendet werden.
WDF_REQUEST_SEND_OPTIONS_FLAGS Der WDF_REQUEST_SEND_OPTIONS_FLAGS Enumerationstyp definiert Flags, die in der WDF_REQUEST_SEND_OPTIONS Struktur eines Treibers verwendet werden.
WDF_REQUEST_STOP_ACTION_FLAGS Der WDF_REQUEST_STOP_ACTION_FLAGS Enumerationstyp definiert Flags, die das Framework an die EvtIoStop-Rückruffunktion eines Treibers übergibt.
WDF_REQUEST_TYPE Der WDF_REQUEST_TYPE Enumerationstyp identifiziert Typen von Anforderungen, die ein Frameworkanforderungsobjekt enthalten kann.