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 llamando a WdfRequestSetInformation o WdfRequestCompleteWithInformation.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
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 por 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 Finalización de 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfrequest.h (incluya Wdf.h) |
| biblioteca de | 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) |