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 de retorno
WdfRequestGetInformation retorna as informações que um driver de nível inferior definiu chamando WdfRequestSetInformation ou WdfRequestCompleteWithInformation.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
Um driver pode chamar WdfRequestSetInformation ou WdfRequestCompleteWithInformation para definir informações de status de conclusão para uma solicitação de E/S. O 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 Concluindo 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
| Requisito | Valor |
|---|---|
| da 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 de DDI | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), kmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |