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

Artigo
02/06/2025

A função pfnAcquireNextModeInfo retorna um descritor do próximo modo em um conjunto de modo de origem do monitor especificado, considerando o modo atual.

Sintaxe

DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}

Parâmetros

[in] hMonitorSourceModeSet

Um identificador para um objeto de conjunto de modo de origem do monitor. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireMonitorSourceModeSet da interface Monitor.

[in] pMonitorSourceModeInfo

Um ponteiro para uma estrutura D3DKMDT_MONITOR_SOURCE_MODE que descreve o modo atual. O driver de miniporto de exibição obteve esse ponteiro anteriormente chamando pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.

[out] ppNextMonitorSourceModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura de D3DKMDT_MONITOR_SOURCE_MODE que descreve o próximo modo.

Valor de retorno

A função pfnAcquireNextModeInfo retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	O identificador fornecido em hMonitorSourceModeSet era inválido.

Observações

Quando terminar de usar a estrutura D3DKMDT_MONITOR_SOURCE_MODE, você deverá liberar a estrutura chamando pfnReleaseModeInfo.

Você pode enumerar todos os modos que pertencem a um objeto de conjunto de modo de origem do monitor específico chamando pfnAcquireFirstModeInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.

O tipo de dados D3DKMDT_HMONITORSOURCEMODESET é definido em D3dkmdt.h.