Função WdfRequestGetCompletionParams (wdfrequest.h)

  • Artigo

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

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer 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 a 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 conterá 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 não deve chamar WdfRequestGetCompletionParams.

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

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

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

Exemplos

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

WDF_REQUEST_COMPLETION_PARAMS completionParams;

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

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfrequest.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

Completionroutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT