Função PoFxSetComponentResidency (wdm.h)

A rotina PoFxSetComponentResidency define o tempo estimado para quanto tempo um componente provavelmente permanecerá ocioso depois que o componente entrar na condição ociosa.

Sintaxe

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Parâmetros

[in] Handle

Um identificador que representa o registro do dispositivo com a PoFx (estrutura de gerenciamento de energia). O driver de dispositivo recebeu anteriormente esse identificador da rotina PoFxRegisterDevice .

[in] Component

O índice que identifica o componente. Esse parâmetro é um índice na matriz Components na estrutura PO_FX_DEVICE que o driver de dispositivo usou para registrar o dispositivo com PoFx. Se a matriz Components contiver N elementos, os índices de componentes variam de 0 a N–1.

[in] Residency

O tempo estimado de residência, em unidades de 100 nanossegundos. Esse parâmetro é uma dica para PoFx sobre quanto tempo o componente provavelmente permanecerá ocioso após uma transição da condição ativa para a condição ociosa. Para obter mais informações, consulte Comentários.

Retornar valor

Nenhum

Comentários

O driver de chamada fornece um tempo de residência estimado que a PoFx pode usar como uma dica para melhorar o desempenho. A PoFx usa essa dica para selecionar um estado Fx de baixa potência apropriado para um componente que está na condição ociosa.

O driver de dispositivo pode chamar PoFxSetComponentResidency sempre que uma alteração nas circunstâncias exigir uma alteração no tempo estimado de residência. Após cada chamada, o novo tempo estimado de residência permanece em vigor até que o driver chame PoFxSetComponentResidency novamente para atualizá-lo.

Se um componente estiver na condição ociosa quando PoFxSetComponentResidency for chamado, PoFx poderá alterar o estado fx do componente para acomodar o novo tempo estimado de residência especificado pelo chamador.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 8.
Plataforma de Destino	Universal
Cabeçalho	wdm.h
Biblioteca	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL