Função StreamClassRegisterAdapter (strmini.h)

Artigo
08/07/2023

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. Depois de 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 DriverEntry do minidriver.

[in] Argument2

Aponta para o segundo argumento para a rotina 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.

Retornar valor

Retorna STATUS_SUCCESS em caso de êxito ou o código de erro apropriado em caso de falha.

Comentários

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

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 para 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 de 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 de SRB_INITIALIZE_DEVICE e SRB_GET_STREAM_INFO para a rotina StrMiniReceiveDevicePacket do minidriver (passada como o membro HwReceivePacket do HW_INITIALIZATION_DATA).

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