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

Ninguno

Observaciones

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.

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 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)

Consulte también

completionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT