Función ScsiPortInitialize (srb.h)

  • Artículo

Para un controlador de miniporte que no sea Plug and Play, la rutina ScsiPortInitialize configura la estructura de PORT_CONFIGURATION_INFORMATION y llama a la rutina HwScsiFindAdapter del controlador de miniporte. ScsiPortInitialize también configura los objetos del sistema y los recursos en nombre de los controladores de miniport. Para un controlador de minipuerto de Plug and Play, ScsiPortInitialize almacena los datos de inicialización del controlador de miniporte para su uso futuro.

Nota Los modelos del controlador de puerto SCSI y del controlador de miniporte SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el controlador Storport y los modelos de controlador de miniport storport .
 

Sintaxis

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

Parámetros

[in] Argument1

Puntero al objeto driver que el sistema operativo pasó al controlador de minipuerto en el primer argumento de su rutina DriverEntry .

[in] Argument2

Puntero a cierta información de contexto que el sistema operativo pasó al controlador de minipuerto en el segundo argumento de su DriverEntry.

[in] HwInitializationData

Puntero a la información de inicialización y configuración proporcionada por DriverEntry.

[in] HwContext

Especifica la dirección de un valor de contexto que se va a pasar a la rutina HwScsiFindAdapter del controlador de miniport. Solo los controladores de miniport heredados que examinan el bus para hbAs en lugar de recibir información de configuración del controlador de puerto pueden usar este parámetro para almacenar el estado entre las llamadas a HwScsiFindAdapter.

Valor devuelto

ScsiPortInitialize devuelve un valor de estado que se usa como valor devuelto de la rutina DriverEntry del controlador de miniport.

Comentarios

Cada rutina driver's DriverEntry del controlador de miniport debe llamar a ScsiPortInitialize después de que el controlador de miniporte se haya cero primero y, a continuación, configure el HW_INITIALIZATION_DATA.

Si un controlador de minipuerto puede admitir HBA en diferentes tipos de buses de E/S, como isa y microchannel , el controlador de minipuerto debe llamar a ScsiPortInitialize para cada tipo de interfaz compatible.

Un controlador de miniporte que llama a ScsiPortInitialize más de una vez debe comprobar el valor devuelto por ScsiPortInitialize en cada llamada y guardar el valor más bajo para todas sus llamadas. La rutina DriverEntry debe devolver el valor más bajo cuando devuelve el control al sistema. Los escritores de controladores de miniport no pueden realizar suposiciones sobre los valores devueltos por ScsiPortInitialize.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado srb.h (incluya Miniport.h, Scsi.h)
Library Scsiport.lib

Consulte también

DriverEntry del controlador miniport SCSI

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter