Função StreamClassRegisterAdapter (strmini.h)

A rotina StreamClassRegisterAdapter registra um minidriver de classe de fluxo.

O nome StreamClassRegisterAdapter tem suporte apenas para compatibilidade com versões anteriores.

Em vez disso, a Microsoft recomenda o uso de StreamClassRegisterMinidriver, um alias de StreamClassRegisterAdapter. O nome StreamClassRegisterMinidriver indica com mais precisão que a rotina registra um minidriver de classe de fluxo. Uma vez registrado, um minidriver pode conduzir qualquer número de instâncias de adaptador em um sistema.

A rotina StreamClassRegisterMinidriver registra um minidriver de fluxo com o driver de classe de fluxo.

Sintaxe

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

Parâmetros

[in] Argument1

Aponta para o primeiro argumento para a rotina de DriverEntry do minidriver.

[in] Argument2

Aponta para o segundo argumento para a rotina de DriverEntry do minidriver.

[in] HwInitializationData

Aponta para uma estrutura HW_INITIALIZATION_DATA que fornece as informações que o driver de classe precisa para começar a inicializar o minidriver.

Valor de retorno

Retorna STATUS_SUCCESS com êxito ou o código de erro apropriado sobre falha.

Observações

Um minidriver de fluxo deve chamar streamClassRegisterMinidriver dentro de sua rotina de DriverEntry.

O DriverEntry do minidriver de fluxo inicializa um minidriver de classe de fluxo. Essa rotina é necessária.

Argument1 Fornece um valor de contexto com o qual o minidriver do adaptador deve chamar StreamClassRegisterMinidriver. Para o Windows 2000 e posterior, isso aponta para um DRIVER_OBJECT.

Argument2 Fornece um segundo valor de contexto com o qual o minidriver do adaptador deve chamar StreamClassRegisterMinidriver. Para o Windows 2000 e posterior, isso aponta para um caminho do Registro.

DriverEntry retorna o valor retornado por sua chamada para streamClassRegisterMinidriver.

Comentários driverEntry é o ponto de entrada inicial de um minidriver de classe de fluxo.

Como StreamClassRegisterMinidriver executa a maior parte da inicialização de driver necessária, a tarefa principal da rotina driverEntry de um minidriver de classe de fluxo é alocar e preencher uma estrutura HW_INITIALIZATION_DATA com constantes e pontos de entrada específicos do driver. Em seguida, o DriverEntry deve chamar StreamClassRegisterMinidriver.

A maioria das informações passadas na estrutura HW_INITIALIZATION_DATA informa o driver de classe dos retornos de chamada em todo o minidriver e quais buffers de tamanho alocar para as estruturas de dados do minidriver. O driver de classe consulta o minidriver para obter informações adicionais de inicialização por meio de solicitações SRB_INITIALIZE_DEVICE e SRB_GET_STREAM_INFO para a rotina de strMiniReceiveDevicePacket do do minidriver (passada como o HwReceivePacket membro do HW_INITIALIZATION_DATA).

Uma vez registrado, um minidriver pode conduzir qualquer número de instâncias de adaptador em um sistema.

Requisitos

Consulte também

HW_INITIALIZATION_DATA

SRB_GET_STREAM_INFO

SRB_INITIALIZE_DEVICE

StrMiniReceiveDevicePacket