OPMGetVideoOutputsFromIDirect3DDevice9Object-Funktion (opmapi.h)

Artikel
03/04/2024

Erstellt ein OPM-Objekt (Output Protection Manager) für jeden physischen Monitor, der einem bestimmten Direct3D-Gerät zugeordnet ist.

Syntax

HRESULT OPMGetVideoOutputsFromIDirect3DDevice9Object(
  [in]  IDirect3DDevice9           *pDirect3DDevice9,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Parameter

[in] pDirect3DDevice9

Zeiger auf die IDirect3DDevice9-Schnittstelle eines Direct3D-Geräts.

[in] vos

Ein Member der OPM_VIDEO_OUTPUT_SEMANTICS-Enumeration .

Wert	Bedeutung
OPM_VOS_OPM_SEMANTICS	Die zurückgegebenen IOPMVideoOutput-Zeiger verwenden OPM-Semantik.
OPM_VOS_COPP_SEMANTICS	Die zurückgegebenen IOPMVideoOutput-Zeiger verwenden COPP-Semantik (Certified Output Protection Protocol).

[out] pulNumVideoOutputs

Empfängt die Anzahl der IOPMVideoOutput-Zeiger , die im pppOPMVideoOutputArray-Parameter zurückgegeben werden.

[out] pppOPMVideoOutputArray

Empfängt einen Zeiger auf ein Array von IOPMVideoOutput-Zeigern . Jeder IOPMVideoOutput-Zeiger ist einem einzelnen physischen Monitor zugeordnet. Der Aufrufer muss jeden Zeiger im Array freigeben und CoTaskMemFree aufrufen, um das Array freizugeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein einzelnes Direct3D-Gerät kann mehreren physischen Monitoren zugeordnet werden. Jeder physische Monitor verfügt über einen eigenen Connector. Die Anwendung muss den Schutzmechanismus für jeden physischen Monitor einzeln festlegen, indem die in pppOPMVideoOutputArray zurückgegebenen IOPMVideoOutput-Zeiger verwendet werden.

Die IOPMVideoOutput-Schnittstelle verfügt abhängig vom Wert des vos-Parameters über zwei Verhaltensmodi. Wenn vos OPM_VOS_COPP_SEMANTICS ist, verwendet IOPMVideoOutput COPP-Semantik. Dieser Modus ist für die Abwärtskompatibilität mit COPP vorgesehen. Wenn vos OPM_VOS_OPM_SEMANTICS ist, verwendet IOPMVideoOutput die neuere OPM-Semantik. Unterschiede im Verhalten werden auf der Referenzseite für jede Methode notiert. Der Modus ändert sich während der Lebensdauer des Objekts nicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	opmapi.h
Bibliothek	Dxva2.lib
DLL	Dxva2.dll

Weitere Informationen

OPM-Funktionen

Freigeben über