WdfRequestRetrieveOutputWdmMdl-Funktion (wdfrequest.h)

[Gilt nur für KMDF]

Die WdfRequestRetrieveOutputWdmMdl-Methode ruft eine Arbeitsspeicherdeskriptorliste (Memory Descriptor List, MDL) ab, die den Ausgabepuffer einer E/A-Anforderung darstellt.

Syntax

NTSTATUS WdfRequestRetrieveOutputWdmMdl(
  [in]  WDFREQUEST Request,
  [out] PMDL       *Mdl
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

[out] Mdl

Ein Zeiger auf eine Position, die einen Zeiger auf eine MDL empfängt.

Rückgabewert

WdfRequestRetrieveOutputWdmMdl gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Der Ausgabepuffer einer Anforderung empfängt Informationen, z. B. Daten von einem Datenträger, die der Treiber dem Absender der Anforderung zur Verfügung stellt. Ihr Treiber kann WdfRequestRetrieveOutputWdmMdl für eine Leseanforderung oder eine Geräte-E/A-Steuerungsanforderung aufrufen, aber nicht für eine Schreibanforderung (da Schreibanforderungen keine Ausgabedaten bereitstellen).

Die WdfRequestRetrieveOutputWdmMdl-Methode ruft die MDL für E/A-Anforderungen des Ausgabepuffers ab, die die gepufferte E/A-Methode oder die direkte E/A-Methode für den Zugriff auf Datenpuffer verwenden. Wenn der E/A-Steuerungscode der Anforderung IRP_MJ_INTERNAL_DEVICE_CONTROL ist oder die Anforderung von einem anderen Kernelmodustreiber stammt, unterstützt WdfRequestRetrieveOutputWdmMdl auch E/A-Anforderungen, die weder gepufferte noch direkte E/A verwenden.

Wenn WdfRequestRetrieveOutputWdmMdl STATUS_SUCCESS zurückgibt, erhält der Treiber einen Zeiger auf eine MDL, die den Ausgabepuffer beschreibt.

Der Treiber darf nach Abschluss der E/A-Anforderung nicht auf die MDL einer Anforderung zugreifen.

Weitere Informationen zu WdfRequestRetrieveOutputWdmMdl finden Sie unter Zugreifen auf Datenpuffer in Framework-Based Treibern.

Beispiele

Das folgende Codebeispiel ist Teil einer EvtIoRead-Rückruffunktion , die eine MDL für den Eingabepuffer einer E/A-Anforderung abruft. Wenn der Aufruf von WdfRequestRetrieveOutputWdmMdl fehlschlägt, schließt der Treiber die Anforderung mit dem Fehler status ab, den WdfRequestRetrieveOutputWdmMdl zurückgibt.

VOID 
MyDrvEvtIoRead(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
    NTSTATUS  status;
    PMDL  mdl = NULL;
...
    status = WdfRequestRetrieveOutputWdmMdl(
                                            Request,
                                            &mdl
                                            );
    if (!NT_SUCCESS(status))
    {
        WdfRequestCompleteWithInformation(
                                          Request,
                                          status,
                                          0
                                          );
    }
...
}

Anforderungen

Weitere Informationen

WdfRequestRetrieveInputWdmMdl