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

Artigo
02/06/2025

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

Sintaxe

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

Parâmetros

[in] hVidPnTargetModeSet

Um identificador para um objeto de conjunto de modo de destino VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireTargetModeSet da interface DXGK_VIDPN_INTERFACE.

[out] ppNewVidPnTargetModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_TARGET_MODE alocada pelo gerenciador VidPN.

Valor de retorno

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

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

Observações

A função pfnCreateNewModeInfo aloca uma estrutura D3DKMDT_VIDPN_TARGET_MODE e define seu membro de ID para um identificador recém-gerado.

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

Preencha o membro informações da estrutura e passe a estrutura para pfnAddMode.
Libere a estrutura chamando pfnReleaseModeInfo.

Ao preencher uma estrutura de D3DKMDT_VIDPN_TARGET_MODE, você tem a opção de substituir o membro de ID que foi gerado e definido por pfnCreateNewModeInfo. No entanto, se você substituir a ID membro de qualquer estrutura D3DKMDT_VIDPN_TARGET_MODE, deverá substituir os membros da ID de todas as estruturas de D3DKMDT_VIDPN_TARGET_MODE obtidas de pfnCreateNewModeInfo. A menos que você tenha um motivo específico para substituir os membros da ID do (por exemplo, acompanhar modos de destino com seu próprio esquema de numeração), você deve deixá-los como definidos por pfnCreateNewModeInfo.

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