Função WdfRequestGetInformation (wdfrequest.h)
[Aplica-se a KMDF e UMDF]
O método WdfRequestGetInformation retorna informações de status de conclusão para uma solicitação de E/S especificada.
Sintaxe
ULONG_PTR WdfRequestGetInformation(
[in] WDFREQUEST Request
);
Parâmetros
[in] Request
Um identificador para um objeto de solicitação de estrutura.
Valor retornado
WdfRequestGetInformation retorna as informações que um driver de nível inferior define chamando WdfRequestSetInformation ou WdfRequestCompleteWithInformation.
Ocorre uma verificação de bug se o driver fornece um identificador de objeto inválido.
Comentários
Um driver pode chamar WdfRequestSetInformation ou WdfRequestCompleteWithInformation para definir informações de status de conclusão para uma solicitação de E/S. Seu driver pode chamar WdfRequestGetInformation depois que um driver de nível inferior concluir uma solicitação para obter informações de status de conclusão definidas pelo driver de nível inferior.
Se o driver chamar WdfRequestGetInformation depois de chamar WdfRequestComplete para concluir a solicitação, WdfRequestGetInformation retornaráNULL.
Para obter mais informações sobre WdfRequestGetInformation, consulte Como concluir solicitações de E/S.
Exemplos
O exemplo de código a seguir envia uma solicitação de E/S para um destino de E/S e obtém informações de status fornecidas pelo destino de E/S.
ULONG_PTR informationRetrieved = NULL;
status = WdfIoTargetSendWriteSynchronously(
ioTarget,
request,
&outputMemoryDescriptor,
NULL,
NULL,
&bytesWritten
);
if (NT_SUCCESS(status)) {
informationRetrieved = WdfRequestGetInformation(request);
}
Requisitos
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1,0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfrequest.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade DDI | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |