Função ScsiPortInitialize (srb.h)

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

Nota O driver de porta SCSI e os modelos de driver de miniporto SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o driver Storport e os modelos de driver de miniporto storport .
 

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 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 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 retornado

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

Comentários

Cada rotina driverEntry de cada miniportor deve chamar ScsiPortInitialize depois que o driver de miniporto tiver zero primeiro 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 os barramentos de E/S do tipo Isa e MicroChannel , o driver de 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 DriverEntry deve retornar o valor mais baixo quando retorna o controle para o sistema. Os gravadores de driver de miniporto não podem fazer suposições sobre os valores retornados por ScsiPortInitialize.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho srb.h (inclua Miniport.h, Scsi.h)
Biblioteca Scsiport.lib

Confira também

DriverEntry do driver de miniporto SCSI

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter