Función WdfRequestGetInformation (wdfrequest.h)

[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

Consulte también

WdfRequestCompleteWithInformation

WdfRequestSetInformation