Pular para o conteúdo principal
Especifica um evento que é gerado quando o fence atinge um determinado valor.

Sintaxe

Parâmetros

Value
Tipo: UINT64
O valor do fence no qual o evento deve ser sinalizado. hEvent
Tipo: HANDLE
Um identificador para o objeto de evento.

Valor retornado

Tipo: HRESULT Este método retorna E_OUTOFMEMORY se os componentes do kernel não tiverem memória suficiente para armazenar o evento em uma lista. Consulte Códigos de retorno do Direct3D 12 para outros valores retornados possíveis.

Comentários

Para especificar vários fences antes que um evento seja disparado, consulte SetEventOnMultipleFenceCompletion. Se hEvent for um identificador nulo, esta API não retornará até que os valores de fence especificados tenham sido atingidos. Este método pode ser chamado com segurança de vários threads ao mesmo tempo.

Exemplos

O exemplo D3D12Multithreading usa ID3D12Fence::SetEventOnCompletion da seguinte maneira:
Consulte o Código de exemplo na referência do Direct3D 12.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12Fence Sincronização de vários mecanismos
Última modificação em 6 de outubro de 2026