estrutura DXGK_MULTIPLANE_OVERLAY_PLANE3 (d3dkmddi.h)

Especifica um plano de sobreposição a ser exibido em uma chamada para a função DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay3.

Sintaxe

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

Membros

LayerIndex

O índice baseado em zero do plano de sobreposição a ser exibido. O plano superior (na direção z) tem índice zero. Os valores de índice dos planos devem ser sequenciais de cima para baixo.

PresentId

Um identificador por plano de 64 bits usado pelo driver para relatar a conclusão do comando de sobreposição.

InputFlags

Uma estrutura DXGK_PLANE_SPECIFIC_INPUT_FLAGS que identifica as operações de exibição específicas do plano a serem executadas.

OutputFlags

Uma estrutura DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS que contém o status retornado pelo driver.

MaxImmediateFlipLine

A linha de exibição que define se um inverter VSYNC deve ser promovido a um inverso imediato, em que a linha 0 corresponde ao primeiro pixel ativo do quadro. Esse valor é ignorado para versões não VSYNC.

Esse valor é -1 quando a promoção de uma inversão VSYNC para uma inversão imediata não é desejada. Nesse caso, a inversão sempre aguardará o próximo VSYNC.

Para um valor diferente de -1, o driver deverá promover essa inversão para um inverso imediato se o HW ainda não tiver iniciado a leitura da linha de exibição especificada. Os valores de 0 podem ser promovidos a inversões imediatas se o HW tiver registros travados para o quadro de exibição atual, mas ainda não tiver iniciado a verificação do primeiro pixel ativo.

O valor da linha de exibição é relativo ao modo físico definido. Se a exibição estiver executando o dimensionamento, a linha de exibição será relativa ao tamanho após a aplicação do dimensionamento.

Quando uma inversão VSYNC é promovida a um inverso imediato, o driver deve definir DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS. FlipConvertedToImmediate para TRUE.

ContextCount

O número de contextos na matriz especificada pelo membro contextual.

ppContextData

Uma matriz de identificadores para os contextos que contribuíram para uma operação de exibição.

DriverPrivateDataSize

O tamanho dos dados do driver privado.

pDriverPrivateData

Dados do driver privado.

PlaneAttributes

Uma estrutura do tipo DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 que especifica atributos de plano de sobreposição.

Requisitos

Requisito	Valor
cabeçalho	d3dkmddi.h