Compartilhar via

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

  • Artigo

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

Sintaxe

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Parâmetros

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

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

Retornar valor

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_SOURCEMODESET O identificador fornecido em hVidPnSourceModeSet era inválido.

Comentários

A função pfnCreateNewModeInfo aloca uma estrutura D3DKMDT_VIDPN_SOURCE_MODE , define seu membro de Id como um identificador recém-gerado e define seu membro Type como D3DKMDT_RMT_UNINITIALIZED.

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

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

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)
IRQL PASSIVE_LEVEL

Confira também

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo