EVT_SERCX_FILEOPEN função de retorno de chamada (sercx.h)
A função de retorno de chamada de evento EvtSerCxFileOpen notifica o driver do controlador serial de que um cliente abriu um identificador de arquivo no dispositivo do controlador serial e que um objeto de arquivo foi criado para representar o dispositivo.
Sintaxe
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador WDFDEVICE para o objeto de dispositivo de estrutura que representa o controlador serial.
Retornar valor
A função EvtSerCxFileOpen retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, ele retornará um erro apropriado status código.
Comentários
A extensão de estrutura serial (SerCx) chama essa função para preparar o hardware do controlador serial para aceitar solicitações para operações de E/S. Essa função deve configurar o controlador em um estado no qual ele está pronto para receber e transmitir dados. Se forem necessárias interrupções, essa função deverá habilitar interrupções. Além disso, essa função deve alocar qualquer memória necessária somente durante o tempo de vida do objeto de arquivo. Por exemplo, essa função pode alocar um buffer de dados de interrupção.
Para registrar uma função de retorno de chamada EvtSerCxFileOpen , 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 NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Para definir uma função de retorno de chamada EvtSerCxFileOpen chamada MyEvtSerCxFileOpen, primeiro você deve 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_FILEOPEN MyEvtSerCxFileOpen;
Em seguida, implemente a função de retorno de chamada da seguinte maneira.
NTSTATUS
MyEvtSerCxFileOpen(
__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 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 |