Compartilhar via

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

  • Artigo

[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