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
| Requisito | Valor |
|---|---|
| da 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) |