Función ScsiPortInitialize (srb.h)

Para un controlador de minipuerto que no sea de Plug and Play, la rutina ScsiPortInitialize configura la estructura 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 de controlador de puerto SCSI y controlador de minipuerto SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar los modelos del controlador Storport y del controlador storport miniport .
 

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 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 miniporte. Solo los controladores de miniporte heredados que examinan el bus en busca de 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 DriverEntry del controlador de miniporte.

Comentarios

Cada rutina driver's DriverEntry del controlador miniport debe llamar a ScsiPortInitialize después de que el controlador de miniporte se haya a 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 minipuerto 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 minipuerto no pueden realizar suposiciones sobre los valores devueltos por ScsiPortInitialize.

Requisitos

   
Plataforma de destino Escritorio
Header srb.h (incluye Miniport.h, Scsi.h)
Library Scsiport.lib

Vea también

DriverEntry del controlador SCSI Miniport

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter