PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB funzione di callback (d3dumddi.h)

Articolo
02/06/2025

Inserisce un comando di attesa per gli oggetti di sincronizzazione specificati nel flusso di comandi di contesto specificato. Usato da Windows Display Driver Model (WDDM) 1.2 e versioni successive driver di visualizzazione in modalità utente.

Sintassi

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

HRESULT Pfnd3dddiWaitforsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Parametri

hDevice

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

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 che descrive gli oggetti di sincronizzazione e il flusso DMA di contesto necessari per configurare l'attesa.

Valore restituito

Restituisce uno dei valori seguenti:

codice restituito	Descrizione
S_OK	L'attesa è 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:

Non chiamare questa funzione se l'oggetto di sincronizzazione è di tipo D3DDDI_CPU_NOTIFICATION, ovvero il membro type della struttura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 ha un valore pari a D3DDDI_CPU_NOTIFICATION.pfnDestroySynchronizationObjectCb

Fabbisogno

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