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

Artigo
02/06/2025

O pfnAcquirePreferredModeInfo retorna um descritor do modo preferencial em um objeto de conjunto de modo de origem do monitor especificado.

Sintaxe

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

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.

[out] ppFirstMonitorSourceModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_SOURCE_MODE. A estrutura contém uma variedade de informações sobre o modo de origem do monitor preferencial, incluindo sua ID e o sinal de vídeo.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A função retornou com êxito um descritor do modo preferencial.
STATIS_GRAPHICS_NO_PREFERRED_MODE	A função foi bem-sucedida, mas o conjunto de modo de origem do monitor especificado não tem um modo preferencial.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	O identificador fornecido no hMonitorSourceModeSet era inválido.

Observações

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

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

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

Compartilhar via