EVT_WDF_REQUEST_CANCEL função de retorno de chamada (wdfrequest.h)

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtRequestCancel de um driver lida com operações que devem ser executadas quando uma solicitação de E/S é cancelada.

Sintaxe

EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;

void EvtWdfRequestCancel(
  [in] WDFREQUEST Request
)
{...}

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura que representa a solicitação de E/S que está sendo cancelada.

Retornar valor

Nenhum

Comentários

Para registrar uma função de retorno de chamada EvtRequestCancel , o driver deve chamar WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx.

Quando a estrutura chama a função de retorno de chamada EvtRequestCancel do driver, se o driver puder cancelar a solicitação, ele deverá:

1. Conclua ou pare de processar a solicitação, juntamente com as sub-solicitações que ela pode ter criado.
2. Chame WdfRequestComplete, especificando um valor status de STATUS_CANCELLED.

Para obter mais informações sobre essa função de retorno de chamada, consulte Cancelando solicitações de E/S.

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)
IRQL	<=DISPATCH_LEVEL

Confira também

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx