EVT_SERCX_FILECLOSE função de retorno de chamada (sercx.h)
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 de estrutura que representa o controlador serial.
Retornar valor
Nenhum
Comentários
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 somente 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 . 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, o 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 Objetos de arquivo de 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 chamada MyEvtSerCxFileClose
, você deve primeiro fornecer uma declaração de função que o SDV ( Verificador de Driver Estático ) 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 |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | sercx.h |
IRQL | Chamado em IRQL <= DISPATCH_LEVEL |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de