Função SerCxInitialize (sercx.h)

Artigo
12/13/2024

O método SerCxInitialize conclui a inicialização da extensão da estrutura serial (SerCx) depois que esse driver cria o objeto de dispositivo associado.

Sintaxe

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

Parâmetros

[in] FxDevice

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

[in] Config

Um ponteiro para uma estrutura de SERCX_CONFIG alocada por chamador que contém informações de configuração para SerCx. O chamador chamou anteriormente a função SERCX_CONFIG_INIT para inicializar essa estrutura.

Valor de retorno

SerCxInitialize retornará STATUS_SUCCESS se for bem-sucedido. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O método foi chamado no IRQL errado; ou o identificador WDFDEVICE não é válido; ou fxDevice ou de configuração é NULL.
STATUS_INSUFFICIENT_RESOURCES	Não foi possível alocar recursos do sistema (normalmente memória).

Observações

O driver do controlador serial chama esse método depois de criar o objeto de dispositivo associado.

SerCxInitialize registra as funções de retorno de chamada de E/S do driver do controlador com SerCx. Além disso, esse método define o modo de transferência para a fila de E/S. Durante a chamada, esse método cria todas as estruturas internas exigidas pelo SerCx (incluindo a fila de E/S para o controlador serial). Depois que esse método é retornado, o SerCx está pronto para processar E/S. No entanto, o driver do controlador pode definir as configurações de hardware do controlador antes de retornar do EvtDriverDeviceAdd retorno de chamada ou antes de adicionar o PDO à lista filho.

Se os parâmetros forem inválidos (conforme descrito em SERCX_CONFIG), do Verificador de Driver gerará um erro.

Essa rotina deve ser chamada antes de confirmar o dispositivo (retornar de EvtDriverDeviceAdd ou adicionar o PDO à lista filho).

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Universal
cabeçalho	sercx.h
IRQL	PASSIVE_LEVEL

Consulte também

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT

Compartilhar via