Compartilhar via

Função StorPortInitializePerfOpts (storport.h)

  • Artigo

A função StorPortInitializePerfOpts inicializa as otimizações de desempenho às quais o driver de miniporto e o driver storport dão suporte usando uma estrutura PERF_CONFIGURATION_DATA .

Sintaxe

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

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host). Esse parâmetro não deve ser NULL.

[in] Query

Se definido como TRUE, o Storport definirá os sinalizadores em PerfConfigData correspondentes às otimizações compatíveis com o Storport. Se definido como FALSE, o Storport inicializará as otimizações especificadas pelos sinalizadores em PerfConfigData.

[in, out] PerfConfigData

Um ponteiro para uma estrutura PERF_CONFIGURATION_DATA fornecida pelo driver de miniporta. Esse parâmetro não deve ser NULL.

Retornar valor

StorPortInitializePerfOpts retorna um dos seguintes valores de status:

Código de retorno Descrição
STOR_STATUS_NOT_IMPLEMENTED
 Essa função não é implementada no sistema operacional ativo.
STOR_STATUS_SUCCESS
 Indica que as configurações de otimização de desempenho foram aplicadas.

Ou se Query for definido como TRUE, o membro Flags da estrutura apontada por PerfConfigData conterá os sinalizadores com suporte.
STOR_STATUS_UNSUCCESSFUL
 O driver de miniporto definiu um sinalizador em PerfConfigData que o Storport não reconheceu ou o driver de miniporto chamou essa rotina de fora da rotina HwStorInitialize fornecida pelo miniport-driver.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Não é possível alocar estruturas internas para dar suporte às otimizações solicitadas.
STOR_STATUS_INVALID_PARAMETER
 O parâmetro HwDeviceExtension ou o parâmetro PerfConfigData era NULL.

Comentários

O driver de miniporto pode chamar StorPortInitializePerfOpts somente durante a rotina HwStorInitialize fornecida pelo miniporto ou a rotina HwStorPassiveInitializeRoutine .

As otimizações de desempenho disponíveis dependem da versão do PERF_CONFIGURATION_DATA. Definir o membro Versioncomo STOR_PERF_VERSION permitirá que todas as otimizações com suporte sejam selecionadas.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)
Regras de conformidade da DDI StorPortPerfOpts(storport)

Confira também

PERF_CONFIGURATION_DATA