Función StorPortInitialize (storport.h)

La rutina StorPortInitialize inicializa los parámetros del controlador de puerto y los datos de extensión. StorPortInitialize también guarda la información del adaptador proporcionada en la rutina driver DriverEntry del controlador de miniport.

Sintaxis

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Parámetros

[in] Argument1

Primer puntero con el que el sistema operativo llamó a la rutina DriverEntry del miniporte.

[in] Argument2

Segundo puntero con el que el sistema operativo llamó a la rutina DriverEntry de los miniportes.

[in] HwInitializationData

Puntero a la información de inicialización y configuración establecida por el controlador de miniport en su rutina DriverEntry.

[in, optional] HwContext

Es la dirección de un valor de contexto que se va a pasar a la rutina HwStorFindAdapter del controlador de miniporte. 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 HwStorFindAdapter.

Valor devuelto

Resultado de las acciones de inicialización realizadas por StorPortInitialize. El controlador de minipuerto devolverá este valor como valor devuelto para su rutina DriverEntry.

StorPortInitialize devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Argument1 es NULL o Argument2 es NULL, OR HwInitializationData es NULL.
STATUS_SUCCESS	Los datos de extensión del controlador y la información del adaptador se inicializaron correctamente.
STATUS_NO_MEMORY	No hay memoria disponible para almacenar un parámetro de inicialización.
STATUS_REVISION_MISMATCH	La versión de la estructura a la que apunta HwInitializationData no es válida para el sistema operativo actual.
STATUS_INSUFFICENT_RESOURCES	Error de asignación para los datos de extensión de objeto de controlador.

Comentarios

Se debe llamar a esta rutina desde la rutina DriverEntry del controlador de miniport.

Dado que los controladores de miniport storport deben admitir PnP, el controlador storport no usa el parámetro HwContext pasado a StorPortInitialize.

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
Library	Storport.lib

Consulte también

HW_INITIALIZATION_DATA

HwStorFindAdapter