PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB funzione di callback (d3dumddi.h)

Articolo
02/25/2024

La funzione pfnCreateSynchronizationObjectCb crea un oggetto di sincronizzazione che un contesto di dispositivo può segnalare e attendere.

Sintassi

PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB Pfnd3dddiCreatesynchronizationobjectcb;

HRESULT Pfnd3dddiCreatesynchronizationobjectcb(
  HANDLE hDevice,
  D3DDDICB_CREATESYNCHRONIZATIONOBJECT *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione,ovvero il contesto grafico, che sarà proprietario dell'oggetto di sincronizzazione creato da pfnCreateSynchronizationObjectCb .

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDICB_CREATESYNCHRONIZATIONOBJECT che descrive l'oggetto di sincronizzazione da creare.

Valore restituito

pfnCreateSynchronizationObjectCb restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	L'oggetto di sincronizzazione è stato creato correttamente.
E_OUTOFMEMORY	PfnCreateSynchronizationObjectCb non è riuscito ad allocare memoria necessaria per il completamento.
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 pfnCreateSynchronizationObjectCb restituisce un handle in modalità kernel all'oggetto di sincronizzazione appena creato nel membro hSyncObject della struttura D3DDDICB_CREATESYNCHRONIZATIONOBJECT a cui punta il parametro pData . Il driver di visualizzazione in modalità utente passa questo handle nelle chiamate alle funzioni seguenti:

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)