PFND3DDDI_RENAME funzione di callback (d3dumddi.h)

Articolo
02/23/2024

La funzione Rinomina informa un driver di visualizzazione in modalità utente per iniziare a usare l'allocazione rinominata restituita in precedenza per la risorsa specificata.

Sintassi

PFND3DDDI_RENAME Pfnd3dddiRename;

HRESULT Pfnd3dddiRename(
  HANDLE hDevice,
  const D3DDDIARG_RENAME *unnamedParam2
)
{...}

Parametri

hDevice

Handle per un dispositivo di visualizzazione, ovvero il contesto grafico.

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDIARG_RENAME che descrive la risorsa o la superficie all'interno di una risorsa da rinominare con una nuova allocazione.

Valore restituito

Rinomina restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	La risorsa viene rinominata correttamente.
E_OUTOFMEMORY	La ridenominazione non è riuscita a allocare la memoria necessaria per il completamento.

Commenti

Nei computer a più processori, il runtime di Microsoft Direct3D chiama la funzione di rinomina del driver di visualizzazione in modalità utente da un thread di lavoro anziché dal thread dell'applicazione principale. Il runtime chiama Rinomina, al massimo, una volta per ogni chiamata riuscita alla funzione LockAsync del driver con il flag di campo di bit ignorato impostato nel membro Flag della struttura D3DDDIARG_LOCKASYNC a cui punta il parametro pData di LockAsync .

Rinomina informa il driver di iniziare a usare l'allocazione rinominata specificata dal membro hCookie della struttura D3DDDIARG_RENAME a cui punta il parametro pDatadi Rinomina. L'handle hCookie è stato restituito in precedenza dalla funzione LockAsync se è stato impostato il flag di campo di bit di eliminazione per la risorsa bloccata.

Dopo che Rinomina restituisce correttamente (con S_OK), il driver di visualizzazione in modalità utente deve usare l'allocazione specificata da hCookie per tutte le operazioni di rendering che fanno riferimento alla risorsa che i membri hResource e SubResourceIndex di D3DDDIARG_RENAME specificare.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	d3dumddi.h (include D3dumddi.h)

Vedi anche