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.
Retornar valor
WdfRequestRetrieveOutputWdmMdl 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 |
|---|---|
|
Um parâmetro de entrada é inválido. |
|
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. |
|
A solicitação já foi concluída. |
|
O comprimento do buffer de entrada é zero. |
|
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 saída de uma solicitação recebe informações, como dados de um disco, que o driver fornece ao originador 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 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, WdfRequestRetrieveOutputWdmMdl também oferecerá suporte a solicitações de E/S que não usam E/S 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 erro status 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
| 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), 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) |