PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB funzione di callback (d3dumddi.h)

Articolo
02/06/2025

Inserisce un segnale negli oggetti di sincronizzazione specificati nel flusso DMA (Context Direct Memory Access) specificato. Usato da WDDM 1.2 e versioni successive driver di visualizzazione in modalità utente.

Sintassi

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Parametri

hDevice

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

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 che descrive gli oggetti di sincronizzazione e il flusso DMA di contesto su cui è configurata la segnalazione.

Valore restituito

Restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	La segnalazione è stata configurata correttamente.
E_INVALIDARG	I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti.

Questa funzione potrebbe restituire anche altri valori HRESULT.

Osservazioni

La funzione pfnCreateSynchronizationObject2Cb restituisce un handle in modalità kernel all'oggetto di sincronizzazione appena creato nel membro hSyncObject della struttura D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 a cui punta il parametro pData. Il driver di visualizzazione in modalità utente passa questo handle nelle chiamate alle funzioni seguenti:

La funzione pfnSignalSynchronizationObject2Cb invia un comando di segnale al flusso di comandi di tutti i contesti Microsoft Direct3D specificati dal hContext e i membri BroadcastContext della struttura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. Gli oggetti di sincronizzazione vengono segnalate solo quando vengono elaborati tutti i comandi di segnale inviati.

Se gli oggetti di sincronizzazione sono di tipo D3DDDI_FENCE (dove D3DDDI_SYNCHRONIZATIONOBJECTINFO2.Type = D3DDDI_FENCE), devono essere inviati solo uno alla volta e D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2.ObjectCount deve avere un valore pari a 1.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Desktop
intestazione	d3dumddi.h (include D3dumddi.h)

Vedere anche

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2

pfnCreateSynchronizationObject2Cb

pfnDestroySynchronizationObjectCb

pfnWaitForSynchronizationObject2Cb

Condividi tramite