Función StorPortInitialize (storport.h)

  • Artículo

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 del controlador de miniporte rutina driverEntry.

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 del controlador de miniport HwStorFindAdapter. Solo los controladores de miniport heredados que examinan el bus para las 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 HwStorFindAdapter.

Valor devuelto

Resultado de las acciones de inicialización realizadas por StorPortInitialize. El controlador de miniporte 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 argumento2 es NULL, O 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 del objeto de controlador.

Observaciones

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

Dado que los controladores de miniport storport deben admitir PnP, el controlador de 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 Valor
de la plataforma de destino de Universal
encabezado de storport.h (incluya Storport.h)
biblioteca de Storport.lib

Consulte también

HW_INITIALIZATION_DATA

HwStorFindAdapter