PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB Rückruffunktion (d3dumddi.h)

Die PfnCreateSynchronizationObjectCb-Funktion erstellt ein Synchronisierungsobjekt, das ein Gerätekontext signalisieren und warten kann.

Syntax

PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB Pfnd3dddiCreatesynchronizationobjectcb;

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

Parameter

hDevice

Ein Handle für das Anzeigegerät (d. h. den Grafikkontext), das das Synchronisierungsobjekt besitzt, das pfnCreateSynchronizationObjectCb erstellt.

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDICB_CREATESYNCHRONIZATIONOBJECT Struktur, die das zu erstellende Synchronisierungsobjekt beschreibt.

Rückgabewert

pfnCreateSynchronizationObjectCb gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Das Synchronisierungsobjekt wurde erfolgreich erstellt.
E_OUTOFMEMORY	pfnCreateSynchronizationObjectCb konnte nicht arbeitsspeicher zugeordnet werden, der für die Vervollständigung erforderlich war.
E_INVALIDARG	Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion kann auch andere HRESULT-Werte zurückgeben.

Hinweise

Die PfnCreateSynchronizationObjectCb-Funktion gibt ein Kernelmodushandle für das neu erstellte Synchronisierungsobjekt im hSyncObject-Member der D3DDDICB_CREATESYNCHRONIZATIONOBJECT-Struktur zurück, auf die der pData-Parameter verweist. Der Benutzermodusanzeigetreiber übergibt dieses Handle in Aufrufen an die folgenden Funktionen:

• pfnDestroySynchronizationObjectCb

• pfnSignalSynchronizationObjectCb

• pfnWaitForSynchronizationObjectCb

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDICB_CREATESYNCHRONIZATIONOBJECT

D3DDDI_DEVICECALLBACKS

pfnDestroySynchronizationObjectCb

pfnSignalSynchronizationObjectCb

pfnWaitForSynchronizationObjectCb