Compartilhar via

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

  • Artigo

A função pfnAcquireNextFrequencyRangeInfo retorna o descritor de intervalo de frequência seguinte em um conjunto de intervalos de frequência de monitor, dado 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 da Interface do Monitor.

[in] pMonitorFrequencyRangeInfo

Um ponteiro para uma estrutura D3DKMDT_MONITOR_FREQUENCY_RANGE que é o descritor de intervalo de frequência atual. O driver de miniporte 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.

Retornar valor

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 de 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 em pMonitorFrequencyRangeInfo era inválido.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET O identificador fornecido em hMonitorFrequencyRangeSet era inválido.

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

Comentários

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 intervalo de frequência de monitor definido chamando pfnAcquireFirstFrequencyRangeInfo e fazendo uma sequência de chamadas para pfnAcquireNextFrequencyRangeInfo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)
IRQL PASSIVE_LEVEL