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

A função pfnAddMode adiciona um modo de origem VidPN a um objeto de conjunto de modo de origem VidPN especificado.

Sintaxe

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parâmetros

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE que descreve o modo de origem. O driver de miniporto de exibição obteve essa estrutura anteriormente chamando pfnCreateNewModeInfo.

Retornar valor

A função pfnAddMode 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

Para adicionar um modo a um conjunto de modo de origem, o driver de miniporta de exibição executa as etapas a seguir.

Chame pfnCreateNewModeInfo para obter um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE . A função pnfCreateNewModeInfo aloca a estrutura, preenche o membro Id com um identificador de modo de origem recém-gerado e define o membro Type como D3DKMDT_RMT_UNINITIALIZED.

Preencha a estrutura de D3DKMDT_VIDPN_SOURCE_MODE (exceto o membro ID ) com informações sobre o modo, incluindo o tipo e o formato do modo.

Chame pfnAddMode para adicionar o modo a um conjunto de modo de origem.

O gerenciador VidPN aloca uma estrutura D3DKMDT_VIDPN_SOURCE_MODE quando você chama pfnCreateNewModeInfo. Se você adicionar o modo descrito por essa estrutura a um conjunto de modo de origem, não precisará liberar explicitamente a estrutura; pfnAddMode o libera.

Se você obtiver uma estrutura D3DKMDT_VIDPN_SOURCE_MODE chamando pfnCreateNewModeInfo e decidir não adicionar esse modo a um conjunto de modo de origem, deverá liberar explicitamente a estrutura chamando pfnReleaseModeInfo.

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

pfnCreateNewModeInfo

pfnReleaseModeInfo