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.
void WdfRequestGetCompletionParams(
[in] WDFREQUEST Request,
[in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);
[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.
Ninguno
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Después de llamar a un controlador 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 se haya completado 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 formateado la solicitud llamando a uno de los métodos WdfIoTargetFormat de Xxx. 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 de forma sincrónica (como WdfIoTargetSendReadSynchronously), el controlador debe no 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 un CompletionRoutine función de devolución de llamada.
Para obtener más información sobre WdfRequestGetCompletionParams, vea Finalización de solicitudes de E/S.
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
);
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) |