Función WdfRequestGetCompletionParams (wdfrequest.h)
[Se aplica a KMDF y UMDF]
El método WdfRequestGetCompletionParams recupera los parámetros de finalización de E/S asociados a un objeto de solicitud de marco especificado.
Sintaxis
void WdfRequestGetCompletionParams(
[in] WDFREQUEST Request,
[in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);
Parámetros
[in] Request
Identificador de un objeto de solicitud de marco.
[in, out] Params
Puntero a una estructura de WDF_REQUEST_COMPLETION_PARAMS proporcionada por el autor de la llamada.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Una vez que un controlador ha llamado a WdfRequestSend para enviar de forma sincrónica o asincrónica una solicitud de E/S a un destino de E/S y después de que el destino de E/S haya completado la solicitud de E/S, el controlador puede llamar a WdfRequestGetCompletionParams para obtener los parámetros de finalización de la solicitud de E/S.
La estructura de parámetros de finalización contiene información válida solo si el controlador ha dado formato a la solicitud llamando a uno de los métodos WdfIoTargetFormatXxx . Por ejemplo, vea WdfIoTargetFormatRequestForRead.
Tenga en cuenta que si el controlador llama a uno de los métodos que envía solicitudes de E/S a destinos de E/S solo sincrónicamente (como WdfIoTargetSendReadSynchronousmente), el controlador no debe llamar a WdfRequestGetCompletionParams.
El método WdfRequestGetCompletionParams copia los parámetros de finalización de la solicitud de E/S en la estructura de WDF_REQUEST_COMPLETION_PARAMS especificada.
Si un controlador envía una solicitud de E/S de forma asincrónica, normalmente llama a este método desde una función de devolución de llamada CompletionRoutine .
Para obtener más información sobre WdfRequestGetCompletionParams, vea Completar solicitudes de E/S.
Ejemplos
En el ejemplo de código siguiente se inicializa una estructura de WDF_REQUEST_COMPLETION_PARAMS y, a continuación, se llama a WdfRequestGetCompletionParams.
WDF_REQUEST_COMPLETION_PARAMS completionParams;
WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
request,
&completionParams
);
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) |