Função StorPortPoFxSetPerfState (storport.h)

StorPortPoFxSetPerfState define o estado P de um componente (desempenho ou estado "perf").

Sintaxe

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

Parâmetros

HwDeviceExtension

Ponteiro para a extensão de dispositivo do miniporte.

Address

Endereço do dispositivo que está sendo registrado. Atualmente, há suporte apenas para adaptadores, portanto, Address deve ser NULL.

Component

O índice que identifica o componente cujos estados P serão gerenciados. Esse parâmetro é um índice na matriz Componentsna estrutura STOR_POFX_DEVICE que o miniporto usou para registrar o dispositivo para suporte do Storport PoFx. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N-1.

Flags

No momento, deve ser definido como NULL.

SetIndex

O índice de um conjunto de perf registrado anteriormente.

State

Se o conjunto de perf contiver estados-P discretos, esse deverá ser um valor de índice. Se o conjunto de perf for um intervalo, esse deverá ser um valor dentro desse intervalo.

Context

Um contexto arbitrário que será passado para o retorno de chamada de alteração do conjunto de perf.

Retornar valor

StorPortPoFxSetPerfState retorna STOR_STATUS_SUCCESS após a conclusão bem-sucedida ou se a energia do runtime foi desabilitada ou um código de erro como um dos seguintes:

Código do erro	Significado
STOR_STATUS_INVALID_PARAMETER	Um dos parâmetros é inválido; por exemplo, Endereço ou Sinalizadores não são NULL.
STOR_STATUS_UNSUCCESSFUL	O adaptador não está registrado para detecção ociosa.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Cabeçalho	storport.h