PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB funzione di callback (d3dumddi.h)

Articolo
02/23/2024

Inserisce un comando wait per gli oggetti di sincronizzazione specificati nel flusso di comandi di contesto specificato. Usato dai driver di visualizzazione Windows Display Driver Model (WDDM) 1.2 e versioni successive.

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 come 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:

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 di D3DDDI_CPU_NOTIFICATION. pfnDestroySynchronizationObjectCb

Requisiti

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