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

Artigo
02/06/2025

A função pfnCreateNewModeInfo retorna um ponteiro para uma estrutura de D3DKMDT_MONITOR_SOURCE_MODE que o driver de miniporto de exibição preenche antes de chamar pfnAddMode.

Sintaxe

DXGKDDI_MONITORSOURCEMODESET_CREATENEWMODEINFO DxgkddiMonitorsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_MONITOR_SOURCE_MODE ppNewMonitorSourceModeInfo
)
{...}

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] ppNewMonitorSourceModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura de D3DKMDT_MONITOR_SOURCE_MODE recém-criada alocada pelo gerenciador VidPN.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_NO_MEMORY	A função falhou porque não foi possível alocar memória suficiente.

Observações

Depois de chamar pfnCreateNewModeInfo para obter uma estrutura de D3DKMDT_MONITOR SOURCE_MODE, você deve fazer uma, mas não ambas, do seguinte:

Preencha a estrutura e passe-a para pfnAddMode.
Libere a estrutura chamando pfnReleaseModeInfo.

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

Partilhar via