Función WdfRequestGetCompletionParams (wdfrequest.h)

  • Artículo

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

Consulte también

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT