Compartir a través de

Función StorPortInitializePerfOpts (storport.h)

  • Artículo

La función StorPortInitializePerfOpts inicializa las optimizaciones de rendimiento que admiten 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 en PerfConfigData.

[in, out] PerfConfigData

Puntero a una estructura PERF_CONFIGURATION_DATA proporcionada por el controlador de minipuerto. 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 Query 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 minipuerto establece una marca en PerfConfigData que Storport no reconoce, o el controlador de minipuerto ha llamado a esta rutina desde fuera de la rutina HwStorInitialize proporcionada por el controlador de miniport.
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 era NULL.

Comentarios

El controlador de miniport puede llamar a StorPortInitializePerfOpts solo durante la rutina HwStorInitialize proporcionada por miniporte o la rutina HwStorPassiveInitializeRoutine .

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

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
Reglas de cumplimiento de DDI StorPortPerfOpts(storport)

Consulte también

PERF_CONFIGURATION_DATA