Função WdfRequestRetrieveOutputWdmMdl (wdfrequest.h)

[Aplica-se somente ao KMDF]

O método WdfRequestRetrieveOutputWdmMdl recupera uma lista de descritores de memória (MDL) que representa o buffer de saída de uma solicitação de E/S.

Sintaxe

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

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura.

[out] Mdl

Um ponteiro para um local que recebe um ponteiro para um MDL.

Valor de retorno

WdfRequestRetrieveOutputWdmMdl retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um dos seguintes valores:

Esse método também pode retornar outros valores NTSTATUS .

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

O buffer de saída de uma solicitação recebe informações, como dados de um disco, que o driver fornece ao criador da solicitação. Seu driver pode chamar WdfRequestRetrieveOutputWdmMdl para uma solicitação de leitura ou uma solicitação de controle de E/S do dispositivo, mas não para uma solicitação de gravação (porque as solicitações de gravação não fornecem dados de saída).

O método WdfRequestRetrieveOutputWdmMdl do recupera o MDL do buffer de saída para solicitações de E/S que usam o método de de E/S em buffer ou o método de E/S direto para acessar buffers de dados. Se o código de controle de E/S da solicitação for IRP_MJ_INTERNAL_DEVICE_CONTROL, ou se a solicitação veio de outro driver no modo kernel, WdfRequestRetrieveOutputWdmMdl também oferecer suporte a solicitações de E/S que usam nem buffer nemde E/S direta.

Se WdfRequestRetrieveOutputWdmMdl retornar STATUS_SUCCESS, o driver receberá um ponteiro para um MDL que descreve o buffer de saída.

O driver não deve acessar o MDL de uma solicitação após concluir a solicitação de E/S.

Para obter mais informações sobre WdfRequestRetrieveOutputWdmMdl, consulte Acessando buffers de dados em drivers Framework-Based.

Exemplos

O exemplo de código a seguir faz parte de uma função de retorno de chamada EvtIoRead que obtém um MDL para o buffer de entrada de uma solicitação de E/S. Se a chamada para WdfRequestRetrieveOutputWdmMdl falhar, o driver concluirá a solicitação com o status de erro que WdfRequestRetrieveOutputWdmMdl retorna.

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

Requisitos

Consulte também

WdfRequestRetrieveInputWdmMdl