Skip to main content
Grava um valor de 32 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: UINT
O valor de 32 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 a operação de gravação. Atualmente, deve ser definido como D3D12XBOX_WRITE_VALUE_BOP_FLAG_NONE. Os sinalizadores D3D12XBOX_WRITE_VALUE_BOP_FLAG_GPU_TIMESTAMP e D3D12XBOX_WRITE_VALUE_BOP_FLAG_SYSTEM_TIMESTAMP solicitam gravações de carimbos de data/hora de 64 bits e só têm suporte com Write64BitValueBottomOfPipe2X.

Valor retornado

Tipo: void Nenhum.

Comentários

O valor de 32 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 provavelmente 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 Wait32BitValueX, Write32BitValueBottomOfPipe2X 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