Función ScsiPortInitialize (srb.h)

Artículo
02/07/2025

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

Nota Los modelos de controlador de puerto SCSI y controlador de miniport SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el del controlador storport de y modelos de controlador de 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 de controlador que el sistema operativo pasó al controlador de miniporte en el primer argumento de su rutina de DriverEntry.

[in] Argument2

Puntero a información de contexto que el sistema operativo pasó al controlador de miniport 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 de HwScsiFindAdapter del controlador de miniport. Solo los controladores de minipuerto heredados que examinan el bus para los HBA 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 de del controlador de miniport DriverEntry.

Observaciones

Cada rutina de controlador de miniporte DriverEntry 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 miniporte puede admitir HBA en diferentes tipos de buses de E/S, como Isa y MicroChannel tipo buses de E/S, el controlador de miniport debe llamar a ScsiPortInitialize para cada tipo de interfaz compatible.

Un controlador de miniport 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 de DriverEntry debe devolver el valor más bajo cuando devuelve el control al sistema. Los escritores de controladores de miniport no pueden hacer suposiciones sobre los valores devueltos por ScsiPortInitialize.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	srb.h (include Miniport.h, Scsi.h)
biblioteca de	Scsiport.lib

Consulte también

DriverEntry del controlador SCSI Miniport

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter

Compartir a través de