Función StorPortInitializePerfOpts (storport.h)

La función StorPortInitializePerfOpts inicializa las optimizaciones de rendimiento que admite tanto el controlador de miniport como el controlador storport mediante una estructura de PERF_CONFIGURATION_DATA.

Sintaxis

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA). Este parámetro no debe ser NULL.

[in] Query

Si se establece en TRUE, Storport establecerá las marcas en PerfConfigData correspondientes a las optimizaciones que admite Storport. Si se establece en FALSE, Storport inicializará las optimizaciones especificadas por las marcas de PerfConfigData.

[in, out] PerfConfigData

Puntero a una estructura PERF_CONFIGURATION_DATA proporcionada por el controlador de miniport. Este parámetro no debe ser NULL.

Valor devuelto

StorPortInitializePerfOpts devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
STOR_STATUS_NOT_IMPLEMENTED	Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS	Indica que se ha aplicado la configuración de optimización del rendimiento. O bien, si consulta se establece en TRUE, el miembro Flags de la estructura a la que apunta PerfConfigData contiene las marcas admitidas.
STOR_STATUS_UNSUCCESSFUL	El controlador de miniporte establece una marca en PerfConfigData que Storport no reconoce, o el controlador de miniporta ha llamado a esta rutina desde fuera de la rutina proporcionada por el controlador de miniport HwStorInitialize rutina.
STOR_STATUS_INSUFFICIENT_RESOURCES	No se pueden asignar estructuras internas para admitir las optimizaciones solicitadas.
STOR_STATUS_INVALID_PARAMETER	El parámetro HwDeviceExtension o el parámetro PerfConfigData se NULL.

Observaciones

El controlador de miniport puede llamar a storPortInitializePerfOpts solo durante la rutina de HwStorInitialize o rutina HwStorPassiveInitializeRoutine.

Las optimizaciones de rendimiento disponibles dependen de la versión de PERF_CONFIGURATION_DATA. Establecer el miembro versión de en STOR_PERF_VERSION permitirá seleccionar todas las optimizaciones admitidas.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	storport.h (incluya Storport.h)
reglas de cumplimiento de DDI	StorPortPerfOpts(storport)

Consulte también

PERF_CONFIGURATION_DATA