EVT_SERCX_FILECLOSE função de retorno de chamada (sercx.h)

Artigo
12/13/2024

A função de retorno de chamada de evento EvtSerCxFileClose notifica o driver do controlador serial de que o objeto de arquivo que representa o dispositivo do controlador serial foi liberado.

Sintaxe

EVT_SERCX_FILECLOSE EvtSercxFileclose;

void EvtSercxFileclose(
  [in] WDFDEVICE Device
)
{...}

Parâmetros

[in] Device

Um identificador WDFDEVICE para o objeto de dispositivo da estrutura que representa o controlador serial.

Valor de retorno

Nenhum

Observações

Essa função deve remover o dispositivo do controlador serial do estado em que ele está pronto para receber e transmitir dados. Essa função deve desabilitar interrupções se as interrupções estiverem habilitadas. Qualquer memória alocada apenas para o tempo de vida do objeto de arquivo deve ser desalocada nessa função ou na função EvtSerCxFileCleanup.

Se o driver do controlador serial implementar uma função EvtSerCxFileCleanup, a extensão da estrutura serial (SerCx) chamará essa função antes de chamar a função EvtSerCxFileClose. O SerCx chama a função EvtSerCxFileCleanup quando um cliente fecha o último identificador para o objeto de arquivo que representa o dispositivo do controlador serial. Após essa chamada, o driver não recebe novas solicitações para operações de E/S. O SerCx chama a função EvtSerCxFileClose quando o objeto de arquivo é liberado, que ocorre somente depois que todas as solicitações de E/S pendentes são concluídas ou canceladas.

Para registrar uma função de retorno de chamada EvtSerCxFileClose, o driver deve chamar o método SerCxInitialize.

Para obter mais informações, consulte de Objetos de Arquivo da Estrutura.

Exemplos

O tipo de função para esse retorno de chamada é declarado em Sercx.h, da seguinte maneira.

typedef VOID
  EVT_SERCX_FILECLOSE(
    __in WDFDEVICE Device
    );

Para definir uma função de retorno de chamada EvtSerCxFileClose denominada MyEvtSerCxFileClose, primeiro você deve fornecer uma declaração de função que SDV (Static Driver Verifier) e outras ferramentas de verificação exigem, da seguinte maneira.

EVT_SERCX_FILECLOSE MyEvtSerCxFileClose;

Em seguida, implemente a função de retorno de chamada da seguinte maneira.

VOID
  MyEvtSerCxFileClose(
    __in WDFDEVICE Device
    )
{ ... }

Para obter mais informações sobre os requisitos de SDV para declarações de função, consulte Declarando funções usando tipos de função para drivers KMDF.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Área de trabalho
cabeçalho	sercx.h
IRQL	Chamado no <DO IRQL = DISPATCH_LEVEL

Consulte também

EvtSerCxFileCleanup

SerCxInitialize

Compartilhar via