Função WdfRequestGetCompletionParams (wdfrequest.h)

[Aplica-se a KMDF e UMDF]

O método WdfRequestGetCompletionParams recupera os parâmetros de conclusão de E/S associados a um objeto de solicitação de estrutura especificado.

Sintaxe

VOID WdfRequestGetCompletionParams(
  [in]      WDFREQUEST                     Request,
  [in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura.

[in, out] Params

Um ponteiro para uma estrutura de WDF_REQUEST_COMPLETION_PARAMS fornecida pelo chamador.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Depois que um driver tiver chamado WdfRequestSend para enviar de forma síncrona ou assíncrona uma solicitação de E/S para um destino de E/S e depois que o destino de E/S tiver concluído solicitação de E/S, o driver poderá chamar WdfRequestGetCompletionParams para obter os parâmetros de conclusão da solicitação de E/S.

A estrutura de parâmetros de conclusão contém informações válidas somente se o driver tiver formatado a solicitação chamando um dos métodos WdfIoTargetFormatXxx. Por exemplo, consulte WdfIoTargetFormatRequestForRead .

Observe que se o driver chamar um dos métodos que envia solicitações de E/S para destinos de E/S apenas de forma síncrona (como WdfIoTargetSendReadSynchronously), o driver deve não chamada WdfRequestGetCompletionParams.

O método WdfRequestGetCompletionParams copia os parâmetros de conclusão da solicitação de E/S na estrutura de WDF_REQUEST_COMPLETION_PARAMS especificada.

Se um driver envia uma solicitação de E/S de forma assíncrona, ele normalmente chama esse método de dentro de uma função de retorno de chamada CompletionRoutine.

Para obter mais informações sobre WdfRequestGetCompletionParams, consulte Concluir solicitações de E/S.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de WDF_REQUEST_COMPLETION_PARAMS e chama WdfRequestGetCompletionParams.

WDF_REQUEST_COMPLETION_PARAMS completionParams;

WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
                              request,
                              &completionParams
                              );

Requisitos

Consulte também

de CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT