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

Confira também

SerCxInitialize