Funzione WdfRequestRetrieveOutputWdmMdl (wdfrequest.h)

[Si applica solo a KMDF]

Il metodo WdfRequestRetrieveOutputWdmMdl recupera un elenco di descrittori di memoria (MDL) che rappresenta il buffer di output di una richiesta di I/O.

Sintassi

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

Parametri

[in] Request

Handle per un oggetto richiesta del framework.

[out] Mdl

Puntatore a una posizione che riceve un puntatore a un MDL.

Valore restituito

WdfRequestRetrieveOutputWdmMdl restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Questo metodo potrebbe anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Il buffer di output di una richiesta riceve informazioni, ad esempio dati da un disco, che il driver fornisce all'origine della richiesta. Il driver può chiamare WdfRequestRetrieveOutputWdmMdl per una richiesta di lettura o una richiesta di controllo di I/O del dispositivo, ma non per una richiesta di scrittura (perché le richieste di scrittura non forniscono dati di output).

Il metodo WdfRequestRetrieveOutputWdmMdl recupera l'MDL del buffer di output per le richieste di I/O che usano il metodo di I/O memorizzato nel buffer o il metodo di I/Odiretto per l'accesso ai buffer di dati. Se il codice di controllo di I/O della richiesta è IRP_MJ_INTERNAL_DEVICE_CONTROL o se la richiesta proviene da un altro driver in modalità kernel, WdfRequestRetrieveOutputWdmMdl supporta anche le richieste di I/O che usano né I/O memorizzate nel buffer né diretto.

Se WdfRequestRetrieveOutputWdmMdl restituisce STATUS_SUCCESS, il driver riceve un puntatore a un MDL che descrive il buffer di output.

Il driver non deve accedere al file MDL di una richiesta dopo aver completato la richiesta di I/O.

Per altre informazioni su WdfRequestRetrieveOutputWdmMdl, vedere Accesso ai buffer di dati nei driver Framework-Based.

Esempio

L'esempio di codice seguente fa parte di una funzione di callback EvtIoRead che ottiene un MDL per il buffer di input di una richiesta di I/O. Se la chiamata a WdfRequestRetrieveOutputWdmMdl ha esito negativo, il driver completa la richiesta con lo stato di errore restituito da WdfRequestRetrieveOutputWdmMdl .

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
                                          );
    }
...
}

Requisiti

Vedi anche

WdfRequestRetrieveInputWdmMdl