Método IDXGISwapChain2::GetFrameLatencyWaitableObject (dxgi1_3.h)

Retorna um identificador de espera que sinaliza quando o adaptador DXGI termina de apresentar um novo quadro.

Windows 8.1 apresenta novas APIs que permitem renderização de latência inferior aguardando até que o quadro anterior seja apresentado à exibição antes de desenhar o próximo quadro. Para usar esse método, primeiro crie a cadeia de troca DXGI com o sinalizador DXGI_SWAP_CHAIN_FLAG_FRAME_LATENCY_WAITABLE_OBJECT definido e, em seguida, chame GetFrameLatencyWaitableObject para recuperar o identificador de espera. Use o identificador de espera com WaitForSingleObjectEx para sincronizar a renderização de cada novo quadro com o final do quadro anterior. Para cada quadro renderizado, o aplicativo deve aguardar esse identificador antes de iniciar qualquer operação de renderização. Observe que esse requisito inclui o primeiro quadro que o aplicativo renderiza com a cadeia de troca. Consulte o exemplo de DirectXLatency. Quando terminar o identificador, use CloseHandle para fechá-lo.

Sintaxe

HANDLE GetFrameLatencyWaitableObject();

Valor retornado

Um identificador para o objeto de espera ou NULL se a cadeia de troca não tiver sido criada com DXGI_SWAP_CHAIN_FLAG_FRAME_LATENCY_WAITABLE_OBJECT.

Comentários

Quando um aplicativo terminar de usar o identificador de objeto retornado por IDXGISwapChain2::GetFrameLatencyWaitableObject, use a função CloseHandle para fechar o identificador.

Requisitos

Confira também

Exemplo de latência do DirectX

GetMaximumFrameLatency

IDXGISwapChain2

SetMaximumFrameLatency