Compartilhar via

Função SerCxInitialize (sercx.h)

  • Artigo

O método SerCxInitialize conclui a inicialização da extensão de 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 de estrutura que representa o controlador serial.

[in] Config

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

Retornar valor

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 Config é NULL.
STATUS_INSUFFICIENT_RESOURCES
 Não foi possível alocar recursos do sistema (normalmente memória).

Comentários

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 retornar, o SerCx estará pronto para processar E/S. No entanto, o driver do controlador pode definir as configurações de hardware do controlador antes de retornar do retorno de chamada EvtDriverDeviceAdd ou antes de adicionar o PDO à lista filho.

Se os parâmetros forem inválidos (conforme descrito em SERCX_CONFIG), o 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
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho sercx.h
IRQL PASSIVE_LEVEL

Confira também

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT