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

Artigo
02/06/2025

A função DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO retorna o primeiro descritor de intervalo de frequência em um objeto de conjunto de intervalo de frequência de monitor especificado.

Sintaxe

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

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 da interface Monitor.

[out] ppFirstMonitorFrequencyRangeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_FREQUENCY_RANGE.

Valor de retorno

A função pfnAcquireFirstFrequencyRangeInfo 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 primeira frequência.
STATUS_GRAPHICS_DATASET_IS_EMPTY	A função foi bem-sucedida, mas não havia descritores de intervalo de frequência no conjunto.
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi fornecido.
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

Compartilhar via