DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO função de retorno de chamada (d3dkmddi.h)

Artigo
02/06/2025

A função pfnAcquireNextFrequencyRangeInfo retorna o descritor de intervalo de frequência seguinte em um conjunto de intervalos de frequência de monitor, considerando o descritor de intervalo de frequência atual.

Sintaxe

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

Parâmetros

[in] hMonitorFrequencyRangeSet

Um identificador para um objeto de conjunto de intervalos de frequência de monitor. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnGetMonitorFrequencyRangeSet do Monitor Interface.

[in] pMonitorFrequencyRangeInfo

Um ponteiro para uma estrutura D3DKMDT_MONITOR_FREQUENCY_RANGE que é o descritor de intervalo de frequência atual. O driver de miniporto de exibição obteve esse ponteiro anteriormente chamando pfnAcquireFirstFrequencyRangeInfo ou pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_FREQUENCY_RANGE que é o descritor de intervalo de frequência seguinte.

Valor de retorno

A função pfnAcquireNextFrequencyRangeInfo retorna um dos valores a seguir.

Código de retorno	Descrição
STATUS_SUCCESS	A função retornou com êxito o descritor do intervalo de frequência seguinte.
STATUS_GRAPHICS_DATASET_IS_EMPTY	A função foi bem-sucedida, mas não havia mais descritores de intervalo de frequência no conjunto.
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi fornecido.
STATUS_INVALID_FREQUENCYRANGE	O descritor de intervalo de frequência fornecido no pMonitorFrequencyRangeInfo era inválido.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	O identificador fornecido no hMonitorFrequencyRangeSet era inválido.

Essa função também pode retornar outros códigos de erro definidos em Ntstatus.h.

Observações

Quando terminar de usar a estrutura D3DKMDT_MONITOR_FREQUENCY_RANGE, você deverá liberar a estrutura chamando pfnReleaseFrequencyRangeInfo.

Você pode obter todos os descritores em um conjunto de intervalos de frequência de monitor chamando pfnAcquireFirstFrequencyRangeInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextFrequencyRangeInfo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Partilhar via