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

Artigo
02/26/2024

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 de gráficos do Microsoft DirectX previamente 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 de vídeo presentes no adaptador de exibição. O objeto de conjunto de modos adicionais ppAdditionalModesSet retornado 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 de um destino presente em vídeo que são compatíveis com o dispositivo de exibição.

Retornar valor

A função pfnAcquireMonitorSourceModeSet retorna 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	Não foi possível encontrar o destino presente do vídeo identificado por VideoPresentTargetId.

Comentários

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

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