Função WdfRequestRetrieveInputWdmMdl (wdfrequest.h)

  • Artigo

[Aplica-se somente ao KMDF]

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

Sintaxe

NTSTATUS WdfRequestRetrieveInputWdmMdl(
  [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.

Retornar valor

WdfRequestRetrieveInputWdmMdl retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá 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 e/S direta nem buffer. 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.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

O buffer de entrada de uma solicitação contém informações, como dados a serem gravados em um disco, que foram fornecidos pelo originador da solicitação. Seu driver pode chamar WdfRequestRetrieveInputWdmMdl para uma solicitação de gravação ou uma solicitação de controle de E/S do dispositivo, mas não para uma solicitação de leitura (porque as solicitações de leitura não fornecem dados de entrada).

O método WdfRequestRetrieveInputWdmMdl recupera o MDL do buffer de entrada para solicitações de E/S que usam o método de E/S armazenado 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, WdfRequestRetrieveInputWdmMdl também oferecerá suporte a solicitações de E/S que não usam E/S não armazenadas em buffer nem diretas.

Se WdfRequestRetrieveInputWdmMdl retornar STATUS_SUCCESS, o driver receberá um ponteiro para um MDL que descreve o buffer de entrada.

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 WdfRequestRetrieveInputWdmMdl, 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 EvtIoWrite que obtém um MDL para o buffer de entrada de uma solicitação de E/S. Se a chamada para WdfRequestRetrieveInputWdmMdl falhar, o driver concluirá a solicitação com o erro status que WdfRequestRetrieveInputWdmMdl retorna.

VOID 
MyDrvEvtIoWrite(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
    NTSTATUS  status;
    PMDL  mdl = NULL;

...
    status = WdfRequestRetrieveInputWdmMdl(
                                           Request,
                                           &mdl
                                           );
    if (!NT_SUCCESS(status))
    {
        WdfRequestCompleteWithInformation(
                                          Request,
                                          status,
                                          0
                                          );
    }
...
}

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfrequest.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), InputBufferAPI(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), MdlAfterReqCompletedIntIoctl(kmdf), MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctl(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedRead(kmdf), MdlAfterReqCompletedWrite(kmdf) , MdlAfterReqCompletedWriteA(kmdf)

Confira também

WdfRequestRetrieveOutputWdmMdl