IDisplayPathInterop::CreateSourcePresentationHandle-Methode (windows.devices.display.core.interop.h)

Artikel
08/27/2023

Erstellt ein NT-Handle zum Steuern des Zugriffs auf scanout für diesen Pfad. Eine Compositor-Anwendung kann den Zugriff auf Pfade vermitteln, die sie mithilfe dieser Objekte steuert. Ihre Anwendung kann IDisplayDeviceInterop.OpenSharedHandle aufrufen, um ein DisplaySource-Objekt aus diesem Handle zu erstellen.

Syntax

HRESULT CreateSourcePresentationHandle(
  HANDLE *pValue
);

Parameter

pValue

Typ: HANDLE*

Ein Zeiger auf eine HANDLE-Instanz , die das neu erstellte Quellpräsentationsobjekt empfängt.

Rückgabewert

Typ: HRESULT

Diese Methode gibt S_OK zurück, wenn sie erfolgreich war, andernfalls einen Fehlercode, der angibt, warum sie fehlgeschlagen ist. Wenn dies erfolgreich war, verweist pValue immer auf das neu erstellte Handle.

Hinweise

Mehrere Prozesse können über Handles desselben Objekts verfügen, wodurch die Verwendung des Objekts für die Prozessübergreifende Synchronisierung oder Freigabe ermöglicht wird. Diese Mechanismen für die Objektfreigabe sind verfügbar.

Ein Prozess kann das Objekthandle in einem Aufruf der DuplicateHandle-Funktion angeben, um ein doppeltes Handle zu erstellen, das von einem anderen Prozess verwendet werden kann.
Ein Prozess kann den Namen des Objekts in einem Aufruf der IDisplayDeviceInterop.OpenSharedHandle-Funktion angeben.

Verwenden Sie die CloseHandle-Funktion , um das Handle zu schließen. Das System schließt das Handle automatisch, wenn der Prozess beendet wird. Das Objekt wird zerstört, wenn sein letztes Handle geschlossen und sein letzter Schnittstellenverweis freigegeben wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Zielplattform	Windows
Kopfzeile	windows.devices.display.core.interop.h
Bibliothek	d3d12.lib
DLL	d3d12.dll

Freigeben über