DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET função de retorno de chamada (d3dkmddi.h)
A função pfnGetMonitorFrequencyRangeSet retorna um identificador para o objeto do conjunto de intervalos de frequência do 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 gráfico do Microsoft DirectX anteriormente forneceu 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 de vídeo presente.
[out] phMonitorFrequencyRangeSet
Um ponteiro para uma variável que recebe um identificador para o objeto de conjunto de intervalo de frequência do 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.
Valor de retorno
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.
Observações
Os identificadores de destino VidPN são atribuídos pelo driver de miniporto de exibição. A função DxgkDdiQueryChildRelations, implementada pelo driver de miniporto de exibição, retorna uma matriz de estruturas de DXGK_CHILD_DESCRIPTOR, cada uma contendo um identificador.
Você não precisa liberar o identificador retornado no phMonitorFrequencyRangeSet.
Essa função também está disponível na interface DXGK_MONITOR_INTERFACE_V2 começando com o Windows 7.
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 |