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 da estrutura que representa o controlador serial.

Valor de retorno

A função EvtSerCxFileOpen retorna STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, ele retornará um código de status de erro apropriado.

Observações

A extensão da 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 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 NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

Para definir uma função de retorno de chamada EvtSerCxFileOpen denominada MyEvtSerCxFileOpen, 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_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 para drivers KMDF.

Requisitos

Consulte também

SerCxInitialize