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

Artigo
02/06/2025

A função pfnGetAdditionalMonitorModeSet retorna um identificador para um objeto de conjunto de modo de origem do monitor adicional associado a um monitor especificado. Ele está disponível na interface DXGK_MONITOR_INTERFACE_V2, começando no Windows 7.

Sintaxe

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Parâmetros

[in] hAdapter

Um identificador que identifica um adaptador de exibição. O subsistema de kernel gráfico 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. A ppAdditionalModesSet objeto de conjunto de modos adicionais descreve os conjuntos de modo de origem do monitor adicionais que estão disponíveis no monitor que está conectado a este destino de vídeo presente.

[out] pNumberModes

Um ponteiro para uma variável que contém o número de modos de tempo adicionais do destino presente do vídeo especificado por VideoPresentTargetId.

[out] ppAdditionalModesSet

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_TARGETMODE_DETAIL_TIMING. A estrutura descreve os modos de tempo adicionais do destino de um vídeo que são compatíveis com o dispositivo de exibição.

Valor de retorno

A funçãopfnAcquireMonitorSourceModeSetretorna um dos valores a seguir.

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
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.
STATUS_NOT_FOUND	O destino presente do vídeo identificado por VideoPresentTargetId não pôde ser encontrado.

Observações

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

Essa função está disponível a partir do Windows 7.