OPMGetVideoOutputsFromHMONITOR-Funktion (opmapi.h)

Erstellt ein OPM-Objekt (Output Protection Manager) für jeden physischen Monitor, der einem bestimmten HMONITOR-Handle zugeordnet ist.

Syntax

HRESULT OPMGetVideoOutputsFromHMONITOR(
  [in]  HMONITOR                   hMonitor,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Parameter

[in] hMonitor

Das Monitorhandle, für das OPM-Objekte erstellt werden sollen. Es gibt mehrere Funktionen, die HMONITOR-Werte zurückgeben. Weitere Informationen finden Sie im Thema Funktionen für mehrere Anzeigemonitore in der GDI-Dokumentation (Windows Graphics Device Interface).

[in] vos

Ein Member der OPM_VIDEO_OUTPUT_SEMANTICS-Enumeration .

[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 HMONITOR-Handle 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 vosOPM_VOS_COPP_SEMANTICS ist, verwendet IOPMVideoOutput COPP-Semantik. Dieser Modus ist für die Abwärtskompatibilität mit COPP vorgesehen. Wenn vosOPM_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

Weitere Informationen

OPM-Funktionen