Função StorPortInitializePerfOpts (storport.h)

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