PFND3DDDI_SETMARKER função de retorno de chamada (d3dumddi.h)

Artigo
02/06/2025

Notifica o driver de exibição do modo de usuário de que ele deve gerar um novo carimbo de data/hora se algum trabalho de GPU tiver sido concluído desde a última chamada para pfnSetMarker. Opcionalmente implementado pelo WDDM (Windows Display Driver Model) 1.3 e drivers posteriores em execução no hardware do Microsoft Direct3D Nível 9. (Consulte os requisitos em melhorias de desempenho de renderização do Direct3D.) Para hardware mais avançado, os drivers devem implementar a função SetMarker.

Sintaxe

PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;

HRESULT Pfnd3dddiSetmarker(
  HANDLE hDevice
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

Valor de retorno

Retorna S_OK ou um resultado de erro apropriado se a função não for concluída com êxito.

Observações

Se o tipo de evento de marcador do parâmetro Type da função pfnSetMarkerMode não for D3DDDIMT_NONE, o driver de exibição no modo de usuário deverá executar este procedimento com cada chamada para pfnSetMarker:

Incremente o valor do membro APISequenceNumber da estrutura D3DDDICB_LOGUMDMARKER.
Determine quais contextos associados às chamadas de renderização de DDI (interface de driver de dispositivo) de thread único enviaram trabalho com a última chamada para pfnSetMarker. Para cada contexto:
1. Se o buffer de comando do contexto estiver vazio, não faça nada.
2. Caso contrário:
  - Verifique se há mais memória disponível no buffer de histórico do contexto. Libere o buffer, se necessário.
  - Adicione outra entrada ao buffer de número de sequência de API do contexto que contém os 32 bits baixos do valor atual APISequenceNumber.
  - Exemplo e carimbos de data/hora que são apropriados para o tipo de evento de marcador atual.
3. Atualize os dados de acompanhamento que serão usados na próxima vez que pfnSetMarker for chamado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.1, WDDM 1.3 e posterior
servidor com suporte mínimo	Windows Server 2012 R2
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dumddi.h (inclua D3d10umddi.h)

Consulte também

SetMarker

pfnSetMarkerMode

Compartilhar via