Função WdfRequestRetrieveOutputWdmMdl (wdfrequest.h)

[Aplica-se somente ao KMDF]

O método WdfRequestRetrieveOutputWdmMdl recupera uma MDL (lista de descritores de memória) 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 retornado

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

Código de retorno Descrição
STATUS_INVALID_PARAMETER
Um parâmetro de entrada é inválido.
STATUS_INVALID_DEVICE_REQUEST
O tipo de solicitação não é válido ou a solicitação não está usando buffer nem E/S direta. Para obter mais informações sobre métodos com suporte para acessar buffers de dados, consulte a seção Comentários a seguir.
STATUS_INTERNAL_ERROR
A solicitação já foi concluída.
STATUS_BUFFER_TOO_SMALL
O comprimento do buffer de entrada é zero.
STATUS_INSUFFICIENT_RESOURCES
Não há memória suficiente.
 

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

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

Comentários

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 recupera o MDL do buffer de saída para solicitações de E/S que usam o método 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 do modo kernel, o WdfRequestRetrieveOutputWdmMdl também oferecerá suporte a solicitações de E/S que não usam E/S direta nem buffer.

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 depois de concluir a solicitação de E/S.

Para obter mais informações sobre WdfRequestRetrieveOutputWdmMdl, consulte Acessando buffers de dados em drivers de 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

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfrequest.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca de Estruturas).)
IRQL <=DISPATCH_LEVEL
Regras de conformidade DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), MdlAfterReqCompletedIntIoctl(kmdf), MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctl(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedRead(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWrite(kmdf), OutputBufferAPI(kmdf)

Confira também

WdfRequestRetrieveInputWdmMdl