Função ScsiPortInitialize (srb.h)

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.

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

Confira também

DriverEntry do driver de miniporto SCSI

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter