PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Rückruffunktion (d3dumddi.h)

Artikel
2025-02-06

Fügt ein Signal für die angegebenen Synchronisierungsobjekte im angegebenen DMA-Datenstrom (Context Direct Memory Access) ein. Wird von WDDM 1.2- und höher-Benutzermodus-Anzeigetreibern verwendet.

Syntax

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für ein Anzeigegerät (d. a. den Grafikkontext).

unnamedParam2

pData- [in]

Ein Zeiger auf eine D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 Struktur, die die Synchronisierungsobjekte und den DMA-Kontextdatenstrom beschreibt, für den die Signalisierung eingerichtet ist.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Signalisierung wurde erfolgreich eingerichtet.
E_INVALIDARG	Parameter wurden überprüft und ermittelt, dass sie falsch sind.

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

Bemerkungen

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

Die pfnSignalSynchronizationObject2Cb--Funktion sendet einen Signalbefehl an den Befehlsstream aller Microsoft Direct3D-Kontexte, die durch die hContext- und BroadcastContext- Member der D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 Struktur angegeben werden. Die Synchronisierungsobjekte werden nur signalisiert, wenn alle übermittelten Signalbefehle verarbeitet werden.

Wenn Synchronisierungsobjekte vom Typ D3DDDI_FENCE sind (wobei D3DDDI_SYNCHRONIZATIONOBJECTINFO2.Typ = D3DDDI_FENCE), müssen sie jeweils nur einzeln übermittelt werden und D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2.ObjectCount- muss den Wert 1 aufweisen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Desktop
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2

pfnCreateSynchronizationObject2Cb-

pfnDestroySynchronizationObjectCb

pfnWaitForSynchronizationObject2Cb-

Freigeben über