Skip to main content
Grava um valor de 64 bits da parte inferior do pipeline em um destino especificado na memória.

​
Sintaxe

​
Parâmetros

Destination   _In_
Tipo: D3D12_GPU_VIRTUAL_ADDRESS O endereço base da memória gráfica no qual o valor será gravado. O endereço deve estar alinhado a 4 bytes. Value   _In_
Tipo: UINT64 O valor de 64 bits a ser gravado no local de memória especificado. SyncFlags   _In_
Tipo: D3D12XBOX_SYNC_FLAGS Um conjunto opcional de diretivas de sincronização a serem executadas em conjunto com a operação de gravação. Os sinalizadores podem ser uma combinação dos seguintes:
  • D3D12XBOX_SYNC_FLAG_VCACHE_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_MCACHE_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_MCACHE_WRITEBACK
  • D3D12XBOX_SYNC_FLAG_GL1_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_GL2_INVALIDATE
  • D3D12XBOX_SYNC_FLAG_GL2_WRITEBACK
  • D3D12XBOX_SYNC_FLAG_GL2_VOLATILE
ControlFlags   _In_
Tipo: D3D12XBOX_SYNC_CONTROL_FLAGS Um conjunto opcional de modificadores de controle a serem aplicados na operação de sincronização. Os sinalizadores podem ser um dos seguintes:
  • D3D12XBOX_SYNC_CONTROL_FLAG_GCR_SEQUENCE_FORWARD
  • D3D12XBOX_SYNC_CONTROL_FLAG_GCR_SEQUENCE_REVERSE
WriteFlags   _In_
Tipo: D3D12XBOX_WRITE_VALUE_BOP_FLAGS Uma combinação OR bit a bit de D3D12XBOX_WRITE_VALUE_BOP_FLAGS que controla o valor gravado na memória (atualmente, apenas um sinalizador é permitido). A origem do valor gravado é baseada nas constantes selecionadas:
  • D3D12XBOX_WRITE_VALUE_BOP_FLAG_NONE especifica o parâmetro Value especificado.
  • D3D12XBOX_WRITE_VALUE_BOP_FLAG_GPU_TIMESTAMP especifica o valor atual do contador de relógio da GPU.
  • D3D12XBOX_WRITE_VALUE_BOP_FLAG_SYSTEM_TIMESTAMP especifica o valor atual do contador de relógio do sistema.

​
Valor retornado

Tipo: void Nenhum.

​
Comentários

O valor de 64 bits é gravado na memória após a conclusão de toda a execução de shaders e do processamento de back-end de renderização, mas antes da conclusão de todas as gravações de memória geradas por draws e dispatches anteriores. Quando usado em conjunto com o método Wait64BitValueX, Write64BitValueBottomOfPipe2X pode servir como um mecanismo útil de sincronização entre mecanismos, dentro da lista de comandos.

​
Requisitos

Cabeçalho: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas compatíveis: consoles XBOX Series

​
Confira também

ID3D12GraphicsCommandList6
d3d12_xs
Last modified on October 6, 2026