PFND3DDDI_RENAME funzione di callback (d3dumddi.h)

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:

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

Vedi anche

D3DDDIARG_LOCKASYNC

D3DDDIARG_RENAME

D3DDDI_DEVICEFUNCS

LockAsync

Rinominare