Compartilhar via

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

  • Artigo

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

Sintaxe

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parâmetros

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Um ponteiro para uma estrutura D3DKMDT_VIDPN_TARGET_MODE que descreve o modo de destino. 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_TARGETMODESET O identificador fornecido em hVidPnTargetModeSet era inválido.

Comentários

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

  1. Chame pfnCreateNewModeInfo para obter um ponteiro para uma estrutura D3DKMDT_VIDPN_TARGET_MODE . A função pnfCreateNewModeInfo aloca a estrutura e preenche o membro Id com um identificador de modo de destino recém-gerado.
  2. O membro Info da estrutura D3DKMDT_VIDPN_TARGET_MODE é uma estrutura D3DKMDT_VIDEO_SIGNAL_MODE . Preencha essa estrutura com informações sobre o modo .
  3. Chame pfnAddMode para adicionar o modo a um conjunto de modo de destino.
O gerenciador VidPN aloca uma estrutura de D3DKMDT_VIDPN_TARGET_MODE quando você chama pfnCreateNewModeInfo. Se você adicionar o modo descrito por essa estrutura a um conjunto de modo de destino, não precisará liberar explicitamente a estrutura; pfnAddMode o libera.

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

O tipo de dados D3DKMDT_HVIDPNTARGETMODESET é 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_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo