PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Rückruffunktion (d3dumddi.h)

Artikel
02/23/2024

Fügt ein Signal für die angegebenen Synchronisierungsobjekte in den angegebenen DMA-Stream (Direct Memory Access) ein. Wird von WDDM 1.2 und höher für Benutzermodusanzeigetreiber verwendet.

Syntax

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

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

Parameter

hDevice

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

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 Struktur, die die Synchronisierungsobjekte und den Kontext-DMA-Stream 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 als falsch ermittelt.

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

Hinweise

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

Die PfnSignalSynchronizationObject2Cb-Funktion sendet einen Signalbefehl an den Befehlsstream aller Microsoft Direct3D-Kontexte, die von den hContext - und BroadcastContext-Membern 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
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)