Função ScsiPortInitialize (srb.h)

Artigo
02/07/2025

Para um driver de miniporto não Plug and Play, a rotina ScsiPortInitialize configura a estrutura PORT_CONFIGURATION_INFORMATION e chama a rotina de do do driver de miniport. ScsiPortInitialize também configura objetos e recursos do sistema em nome de drivers de miniport. Para um driver de miniporto Plug and Play, ScsiPortInitialize armazena os dados de inicialização do driver de miniporto para uso futuro.

Observação o driver de porta SCSI e os modelos de driver de miniporto SCSI podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

Sintaxe

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Parâmetros

[in] Argument1

Ponteiro para o objeto driver que o sistema operacional passou para o driver de miniporto no primeiro argumento de sua rotina de DriverEntry.

[in] Argument2

Ponteiro para algumas informações de contexto que o sistema operacional passou para o driver de miniporto no segundo argumento de seu DriverEntry.

[in] HwInitializationData

Ponteiro para as informações de inicialização e configuração fornecidas pelo DriverEntry.

[in] HwContext

Especifica o endereço de um valor de contexto a ser passado para a rotina de HwScsiFindAdapter do driver de miniport. Somente os drivers de miniporto herdados que verificam o barramento para HBAs em vez de receber informações de configuração do driver de porta podem usar esse parâmetro para armazenar o estado entre chamadas para HwScsiFindAdapter.

Valor de retorno

ScsiPortInitialize retorna um valor de status que é usado como o valor retornado da rotina DriverEntry do driver de miniport.

Observações

A rotina driverEntry de cada driver de miniporto deve chamar ScsiPortInitialize depois que o driver do miniporto tiver zerado pela primeira vez e, em seguida, configurar o HW_INITIALIZATION_DATA.

Se um driver de miniporto puder dar suporte a HBAs em diferentes tipos de ônibus de E/S, como Isa e microChannel ônibus de E/S do tipo, o motorista do miniporto deverá chamar ScsiPortInitialize para cada tipo de interface com suporte.

Um driver de miniporto que chama ScsiPortInitialize mais de uma vez deve verificar o valor retornado por ScsiPortInitialize em cada chamada e salvar o valor mais baixo para todas as suas chamadas. A rotina de DriverEntry deve retornar o valor mais baixo quando retornar o controle ao sistema. Os gravadores de driver miniport não podem fazer suposições sobre os valores retornados por ScsiPortInitialize.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	srb.h (inclua Miniport.h, Scsi.h)
biblioteca	Scsiport.lib

Consulte também

DriverEntry do do Driver de Miniporto SCSI

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter

Partilhar via