Compartilhar via

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

  • Artigo

Notifica o driver de exibição do modo de usuário de que ele deve gerar um novo carimbo de data/hora se qualquer trabalho de GPU tiver sido concluído desde a última chamada para pfnSetMarker. Opcionalmente implementado por drivers WDDM (Windows Display Driver Model) 1.3 e posteriores em execução no hardware do Microsoft Direct3D Nível 9. (Confira 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).

Retornar valor

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

Comentários

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 do modo de usuário deverá executar este procedimento com cada chamada para pfnSetMarker:

  1. Incremente o valor do membro APISequenceNumber da estrutura D3DDDICB_LOGUMDMARKER .
  2. Determine quais contextos associados a 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 desse tipo:
    1. Se o buffer de comando para o 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 de APISequenceNumber .
      • Exemplo e carimbos de data/hora de gravação apropriados para o tipo de evento de marcador atual.
    3. Atualize os dados de rastreamento que serão usados na próxima vez que pfnSetMarker for chamado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1, WDDM 1.3 e posterior
Servidor mínimo com suporte Windows Server 2012 R2
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3d10umddi.h)

Confira também

SetMarker

pfnSetMarkerMode