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

A função pfnGetMonitorFrequencyRangeSet retorna um identificador para o objeto de conjunto de intervalos de frequência de monitor associado a um monitor especificado.

Sintaxe

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

Parâmetros

[in] hAdapter

Um identificador que identifica um adaptador de exibição. O subsistema de kernel de elementos gráficos do Microsoft DirectX forneceu anteriormente esse identificador para o driver de miniporto de exibição no parâmetro DxgkInterface da função DxgkDdiStartDevice .

[in] VideoPresentTargetId

Um inteiro que identifica um dos destinos presentes do vídeo no adaptador de exibição. O objeto de conjunto de intervalos de frequência de monitor retornado descreve os intervalos de frequência disponíveis no monitor que está conectado a este destino presente do vídeo.

[out] phMonitorFrequencyRangeSet

Um ponteiro para uma variável que recebe um identificador para o objeto de conjunto de intervalos de frequência de monitor.

[out] ppMonitorFrequencyRangeSetInterface

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_MONITORFREQUENCYRANGESET_INTERFACE . A estrutura contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar o objeto do conjunto de intervalos de frequência do monitor.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi fornecido.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	O identificador fornecido no hAdapter era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	O identificador fornecido em VideoPresentTargetId era inválido.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Não há nenhum monitor conectado ao destino presente do vídeo identificado por VideoPresentTargetId.

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

Comentários

Os identificadores de destino VidPN são atribuídos pelo driver de miniporto de exibição. AfunçãoDxgkDdiQueryChildRelations, implementada pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR, cada uma contendo um identificador.

Você não precisa liberar o identificador retornado em phMonitorFrequencyRangeSet.

Essa função também está disponível na interface DXGK_MONITOR_INTERFACE_V2 começando com o Windows 7.

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

Confira também

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality