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