PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB funzione di callback (d3dumddi.h)

Articolo
08/07/2023

Inserisce un segnale negli oggetti di sincronizzazione specificati nel flusso DMA (Context Direct Memory Access) specificato. Usato da WDDM 1.2 e versioni successive dei 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 è configurato il segnale.

Valore restituito

Restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Il segnale è stato configurato correttamente.
E_INVALIDARG	I parametri sono stati convalidati e determinati per essere non corretti.

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

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 comando di tutti i contesti microsoft Direct3D specificati dai membri hContext e BroadcastContext della struttura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. Gli oggetti di sincronizzazione vengono segnalati solo quando vengono elaborati tutti i comandi di segnale inviati.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)