Función WdfRequestGetInformation (wdfrequest.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfRequestGetInformation devuelve información de estado de finalización para una solicitud de E/S especificada.

Sintaxis

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco.

Valor devuelto

WdfRequestGetInformation devuelve la información que establece un controlador de nivel inferior mediante una llamada a WdfRequestSetInformation o WdfRequestCompleteWithInformation.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Un controlador puede llamar a WdfRequestSetInformation o WdfRequestCompleteWithInformation para establecer la información de estado de finalización de una solicitud de E/S. El controlador puede llamar a WdfRequestGetInformation después de que un controlador de nivel inferior complete una solicitud para obtener información de estado de finalización establecida en el controlador de nivel inferior.

Si el controlador llama a WdfRequestGetInformation después de llamar a WdfRequestComplete para completar la solicitud, WdfRequestGetInformation devuelve NULL.

Para obtener más información sobre WdfRequestGetInformation, vea Completar solicitudes de E/S.

Ejemplos

En el ejemplo de código siguiente se envía una solicitud de E/S a un destino de E/S y, a continuación, se obtiene información de estado proporcionada por el 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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfrequest.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfRequestCompleteWithInformation

WdfRequestSetInformation