Função WdfRequestRetrieveInputWdmMdl (wdfrequest.h)

Artigo
07/02/2025

[Aplica-se somente ao KMDF]

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

Valor de retorno

WdfRequestRetrieveInputWdmMdl retornará 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 está usando nem em buffer nemde 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 .

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

Observações

O buffer de entrada de uma solicitação contém informações, como dados a serem gravados em um disco, que foram fornecidas pelo originador da solicitação. O 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 do recupera o MDL do buffer de entrada 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_CONTROLou se a solicitação veio de outro driver no modo kernel, WdfRequestRetrieveInputWdmMdl também dá suporte a solicitações de E/S que usam não em buffer nemde E/S direta.

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

Para obter mais informações sobre WdfRequestRetrieveInputWdmMdl, 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 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 status de erro 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
da 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 da 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), MdlAfterter, MdlAfterReqCompletedRead(kmdf), MdlAfterReqCompletedWrite(kmdf), MdlAfterReqCompletedWriteA(kmdf)

Consulte também

WdfRequestRetrieveOutputWdmMdl

Compartilhar via