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)

Confira também

WdfRequestCompleteWithInformation

WdfRequestSetInformation