estrutura DXGIDDICB_PRESENT (dxgiddi.h)

Artigo
08/07/2023

A estrutura DXGIDDICB_PRESENT descreve alocações das quais o conteúdo é copiado de e para.

Sintaxe

typedef struct DXGIDDICB_PRESENT {
  [in] D3DKMT_HANDLE               hSrcAllocation;
  [in] D3DKMT_HANDLE               hDstAllocation;
  [in] void                        *pDXGIContext;
  [in] HANDLE                      hContext;
  [in] UINT                        BroadcastContextCount;
       HANDLE                      BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
       D3DKMT_HANDLE               *BroadcastSrcAllocation;
       D3DKMT_HANDLE               *BroadcastDstAllocation;
       UINT                        PrivateDriverDataSize;
       PVOID                       pPrivateDriverData;
       BOOLEAN                     bOptimizeForComposition;
       BOOL                        SyncIntervalOverrideValid;
       DXGI_DDI_FLIP_INTERVAL_TYPE SyncIntervalOverride;
} DXGIDDICB_PRESENT;

Membros

[in] hSrcAllocation

Um tipo de dados D3DKMT_HANDLE que representa um identificador do modo kernel para a alocação de origem. A função pfnAllocateCb do runtime do Microsoft Direct3D retorna esse identificador. Portanto, o driver de exibição do modo de usuário deve usar esse identificador para copiar o conteúdo.

[in] hDstAllocation

Um tipo de dados D3DKMT_HANDLE que representa um identificador do modo kernel para a alocação de destino. hDstAllocation poderá ser zero se o destino for desconhecido; O modo kernel determinará o destino pouco antes de enviar o fluxo de comando de hardware por meio do DMA para o processador de gráficos.

[in] pDXGIContext

Um identificador para o contexto DXGI (Infraestrutura Gráfica do Microsoft DirectX). Esse identificador é opaco para o driver. O driver deve atribuir o identificador do membro pDXGIContext da estrutura DXGI_DDI_ARG_PRESENT que o driver recebeu em uma chamada para sua função PresentDXGI a esse membro.

[in] hContext

Um identificador para o contexto para o qual o driver envia a operação de cópia. O driver de exibição do modo de usuário criou esse contexto anteriormente chamando a função pfnCreateContextCb .

[in] BroadcastContextCount

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

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Uma matriz de identificadores para os contextos adicionais para os qual transmitir a operação atual atual. A constante D3DDDI_MAX_BROADCAST_CONTEXT , que é definida como 64, define o número máximo de contextos adicionais para os quais o driver de exibição do modo de usuário pode transmitir a operação atual.

A difusão tem suporte apenas para operações de inversão. Para transmitir uma operação de inversão, o driver de miniporto de exibição deve dar suporte a versões baseadas em E/S (E/S mapeada) de memória. Para indicar o suporte a inversãos de MMIO, o driver de miniporto de exibição define o sinalizador de campo de bit FlipOnVSyncMmIo no membro FlipCaps da estrutura DXGK_DRIVERCAPS quando sua função DxgkDdiQueryAdapterInfo é chamada.

O contexto original que o membro hContext especifica e que o driver de exibição do modo de usuário apresenta não é um elemento na matriz BroadcastContext . Por exemplo, se a matriz BroadcastContext contiver um elemento, o driver de exibição do modo de usuário enviará a operação atual para o contexto proprietário (hContext) e transmitirá para esse contexto adicional.

BroadcastSrcAllocation

Alocações que o conteúdo será apresentado.

BroadcastDstAllocation

Se não for zero, representará as alocações de destino do presente.

PrivateDriverDataSize

Tamanho dos dados do driver privado em bytes.

pPrivateDriverData

Dados do driver privado a serem passados para DxgiPresent.

bOptimizeForComposition

O DWM está envolvido na composição.

SyncIntervalOverrideValid

O intervalo de sincronização do aplicativo de substituição é válido.

SyncIntervalOverride

Substitua o intervalo de sincronização do aplicativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	dxgiddi.h (inclua D3d10umddi.h)

Confira também

DXGI_DDI_ARG_PRESENT

DXGK_DRIVERCAPS

DxgkDdiQueryAdapterInfo