Compartilhar via

Função ScsiPortInitialize (srb.h)

  • Artigo

Para um driver de miniporto 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 miniporta. Para um driver de miniporta Plug and Play, o ScsiPortInitialize armazena os dados de inicialização do driver de miniport para uso futuro.

Nota O driver de porta SCSI e os modelos de driver de miniporta SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver storport e 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 de 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 miniport 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 drivers de miniporta herdados que examinam 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.

Retornar valor

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

Comentários

A rotina DriverEntry de cada driver de miniporte deve chamar ScsiPortInitialize depois que o driver de 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 ônibus 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 miniporta que chama ScsiPortInitialize mais de uma vez deve marcar 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 miniport não podem fazer suposições sobre os valores retornados por ScsiPortInitialize.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
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