wdfrequest.h-Header

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

• Windows-Treiberframework

wdfrequest.h enthält die folgenden Programmierschnittstellen:

Functions

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 einen neuen 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 eine Vervollständigung status bereit.
WdfRequestCompleteWithInformation Die WdfRequestCompleteWithInformation-Methode speichert Vervollständigungsinformationen und schließt dann eine angegebene E/A-Anforderung mit einer angegebenen Vervollständigung status ab.
WdfRequestCompleteWithPriorityBoost Die WdfRequestCompleteWithPriorityBoost-Methode schließt eine angegebene E/A-Anforderung ab und stellt eine Vervollständigung status bereit. Es gibt auch einen Wert an, 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 Frameworkanforderungsobjekt.
WdfRequestCreateFromIrp Die WdfRequestCreateFromIrp-Methode erstellt ein Frameworkanforderungsobjekt 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 sendet eine E/A-Anforderung erneut an eine der E/A-Warteschlangen des aufrufenden Treibers.
WdfRequestForwardToParentDeviceIoQueue Die WdfRequestForwardToParentDeviceIoQueue-Methode stellt eine E/A-Anforderung aus der E/A-Warteschlange eines untergeordneten Geräts an eine angegebene E/A-Warteschlange des übergeordneten Geräts des untergeordneten Geräts zurück.
WdfRequestGetCompletionParams Die WdfRequestGetCompletionParams-Methode ruft die E/A-Vervollständigungsparameter ab, die einem angegebenen Frameworkanforderungsobjekt 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 die Vervollständigung status Informationen für eine angegebene E/A-Anforderung zurück.
WdfRequestGetIoQueue Die WdfRequestGetIoQueue-Methode gibt ein Handle an das Framework-Warteschlangenobjekt zurück, von dem eine angegebene E/A-Anforderung übermittelt wurde.
WdfRequestGetParameters Die WdfRequestGetParameters-Methode ruft die Parameter ab, die einem angegebenen Frameworkanforderungsobjekt 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 die status einer E/A-Anforderung zurück.
WdfRequestGetUserModeDriverInitiatedIo Die WdfRequestGetUserModeDriverInitiatedIo-Methode bestimmt, ob eine E/A-Anforderung als von einem UMDF-Treiber initiiert markiert 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 Urheber einer angegebenen E/A-Anforderung eine 32-Bit-Anwendung im Benutzermodus 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 eines ist, das das Framework reserviert hat, um den garantierten Vorwärtsfortschritt in Situationen mit wenig Arbeitsspeicher zu unterstützen.
WdfRequestMarkCancelable Die WdfRequestMarkCancelable-Methode ermöglicht das Abbrechen 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, damit Treiber im Treiberstapel den Puffer lesen können.
WdfRequestProbeAndLockUserBufferForWrite Die WdfRequestProbeAndLockUserBufferForWrite-Methode überprüft, ob der Benutzermoduspuffer einer E/A-Anforderung schreibbar 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 Frameworkspeicherobjekt ab, das den Eingabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveInputWdmMdl Die WdfRequestRetrieveInputWdmMdl-Methode ruft eine Arbeitsspeicherdeskriptorliste (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 für ein Frameworkspeicherobjekt ab, das den Ausgabepuffer einer E/A-Anforderung darstellt.
WdfRequestRetrieveOutputWdmMdl Die WdfRequestRetrieveOutputWdmMdl-Methode ruft eine Arbeitsspeicherdeskriptorliste (Memory Descriptor List, 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-Vorgänge 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-Vorgänge ist.
WdfRequestReuse Die WdfRequestReuse-Methode initialisiert ein Frameworkanforderungsobjekt neu, 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 hebt die Registrierung einer Vervollständigungsroutine für das angegebene Frameworkanforderungsobjekt auf.
WdfRequestSetInformation Die WdfRequestSetInformation-Methode legt die Vervollständigung status Informationen für eine angegebene E/A-Anforderung fest.
WdfRequestSetUserModeDriverInitiatedIo Die WdfRequestSetUserModeDriverInitiatedIo-Methode gibt Kernelmodustreiber an, die sich unterhalb des UMDF-Treibers im selben Gerätestapel befinden, wie eine bestimmte Anforderung behandelt werden soll, als ob sie von einem UMDF-Treiber stammt.
WdfRequestStopAcknowledge Die WdfRequestStopAcknowledge-Methode informiert das Framework darüber, 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-E/A-Stapelspeicherortstruktur an den nächsten Stapelspeicherort in der Anforderung kopiert wird.
WdfRequestWdmGetIrp Die WdfRequestWdmGetIrp-Methode gibt die WDM-IRP-Struktur zurück, die einem angegebenen Frameworkanforderungsobjekt 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 ausführt.
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 Zurückstellen einer E/A-Anforderung aus der E/A-Warteschlange eines untergeordneten Geräts an 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.