Função WdfRequestGetInformation (wdfrequest.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfRequestGetInformation retorna informações de conclusão status 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.

Retornar valor

WdfRequestGetInformation retorna as informações que um driver de nível inferior definiu chamando WdfRequestSetInformation ou WdfRequestCompleteWithInformation.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Um driver pode chamar WdfRequestSetInformation ou WdfRequestCompleteWithInformation para definir a conclusão status informações 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 a conclusão status informações que o driver de nível inferior definiu.

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, em seguida, obtém status informações 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
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 da DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfRequestCompleteWithInformation

WdfRequestSetInformation