PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION função de retorno de chamada (d3d10umddi.h)

Artigo
02/06/2025

SetHardwareProtection permite que os buffers de cadeia de troca de tela inteira do DWM (Gerenciador de Janelas da Área de Trabalho) sejam transferidos entre estados protegidos e não protegidos sem precisar ser recriados.

Sintaxe

PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION Pfnd3dwddm20DdiSethardwareprotection;

void Pfnd3dwddm20DdiSethardwareprotection(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hResource,
  BOOL Protected
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico). O runtime do Direct3D passou o driver no modo de usuário que esse identificador é o hDevice membro da estrutura D3DDDIARG_CREATEDEVICE na criação do dispositivo.

hResource

Um identificador para o objeto de recurso que foi criado por meio de uma chamada para o CreateResourceDDI.

Protected

Indica que o buffer deve ser protegido.

Valor de retorno

Nenhum

Observações

Destruir e recriar os buffers de cadeia de troca dwm é uma operação de peso pesado que pode ser evitada em alguns hardwares. Essa DDI só será chamada se o driver relatar a funcionalidade de D3DWDDM2_0DDI_CONTENT_PROTECTION_CAPS_HARDWARE_PROTECTED_MEMORY_TRANSITION. Se isso não estiver definido, as alocações de cadeia de troca de DWM subjacentes serão destruídas e recriadas.

SetHardwareProtection é chamado nos buffers de cadeia de troca não visíveis, permitindo que ele faça a transição entre modos protegidos e desprotegidos sem causar um artefato visual. Quando o DWM for invertido para o buffer recém-alterado, o DWM chamará SetHardwareProtection no próximo buffer no buffer de cadeia de troca e assim por diante até que o novo estado de proteção tenha sido definido em cada um dos buffers de cadeia de troca.

Observação o DWM tem a garantia de renderizar novamente todo o buffer da cadeia de troca após a alteração do estado de proteção de hardware.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Área de trabalho
cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

CreateResource

D3DDDIARG_CREATEDEVICE

Partilhar via