PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION funzione di callback (d3d10umddi.h)

Articolo
02/06/2025

SetHardwareProtection consente ai buffer della catena di scambio a schermo intero di Desktop Window Manager (DWM) di trasferire tra stati protetti e non protetti senza dover essere ricreati.

Sintassi

PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION Pfnd3dwddm20DdiSethardwareprotection;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico). Il runtime Direct3D ha passato il driver in modalità utente questo handle come membro hDevice della struttura D3DDDIARG_CREATEDEVICE alla creazione del dispositivo.

hResource

Handle per l'oggetto risorsa creato tramite una chiamata all'CreateResourceDDI.

Protected

Indica che il buffer deve essere protetto.

Valore restituito

Nessuno

Osservazioni

L'eliminazione e la ricreazione dei buffer della catena di scambio DWM è un'operazione heavyweight che può essere evitata in alcuni hardware. Questa DDI verrà chiamata solo se il driver segnala la funzionalità di D3DWDDM2_0DDI_CONTENT_PROTECTION_CAPS_HARDWARE_PROTECTED_MEMORY_TRANSITION. Se non è impostato, le allocazioni della catena di scambio DWM sottostanti verranno eliminate e ricreate.

setHardwareProtection viene chiamato nei buffer della catena di scambio non visibili che consentono la transizione tra modalità protette e non protette senza causare un artefatto visivo. Quando il DWM passa al buffer appena modificato, DWM chiamerà SetHardwareProtection nel buffer successivo nel buffer della catena di scambio e così via fino a quando il nuovo stato di protezione non è stato impostato su ognuno dei buffer della catena di scambio.

Nota Il DWM è garantito di eseguire nuovamente il rendering dell'intero buffer della catena di scambio dopo la modifica dello stato di protezione hardware.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Desktop
intestazione	d3d10umddi.h (include D3d10umddi.h)

Vedere anche

CreateResource

D3DDDIARG_CREATEDEVICE

Condividi tramite