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 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 |