Compartilhar via

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

  • Artigo

A função DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO retorna o primeiro descritor de intervalo de frequência em um objeto de conjunto de intervalos 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 miniporta 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 .

Retornar valor

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 primeiro descritor de intervalo de 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 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 conjunto de intervalos de frequência de monitor chamando pfnAcquireFirstFrequencyRangeInfo e, em seguida, 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