Funzione OPMGetVideoOutputsFromHMONITOR (opmapi.h)

Articolo
08/25/2023

Crea un oggetto OPM (Output Protection Manager) per ogni monitoraggio fisico associato a un determinato handle HMONITOR .

Sintassi

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

Parametri

[in] hMonitor

Handle di monitoraggio per il quale creare oggetti OPM. Esistono diverse funzioni che restituiscono valori HMONITOR . Per altre informazioni, vedere l'argomento Più funzioni monitoraggi display nella documentazione dell'interfaccia del dispositivo grafica Windows (GDI).

[in] vos

Membro dell'enumerazione OPM_VIDEO_OUTPUT_SEMANTICS .

Valore	Significato
OPM_VOS_OPM_SEMANTICS	I puntatori IOPMVideoOutput restituiti useranno la semantica OPM.
OPM_VOS_COPP_SEMANTICS	I puntatori IOPMVideoOutput restituiti useranno la semantica COPP (Certified Output Protection Protocol).

[out] pulNumVideoOutputs

Riceve il numero di puntatori IOPMVideoOutput restituiti nel parametro pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Riceve un puntatore a una matrice di puntatori IOPMVideoOutput . Ogni puntatore IOPMVideoOutput è associato a un singolo monitor fisico. Il chiamante deve rilasciare ogni puntatore nella matrice e chiamare CoTaskMemFree per liberare la matrice.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un singolo handle HMONITOR può essere associato a diversi monitor fisici. Ogni monitoraggio fisico ha il proprio connettore. L'applicazione deve impostare il meccanismo di protezione singolarmente per ogni monitoraggio fisico, usando i puntatori IOPMVideoOutput restituiti in pppOPMVideoOutputArray.

L'interfaccia IOPMVideoOutput ha due modalità di comportamento, a seconda del valore del parametro vos . Se vos è OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput usa la semantica COPP. Questa modalità è destinata alla compatibilità con le versioni precedenti con COPP. Se vos è OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput usa la semantica OPM più recente. Le differenze nel comportamento vengono annotate nella pagina di riferimento per ogni metodo. La modalità non cambia durante la durata dell'oggetto.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	opmapi.h
Libreria	Dxva2.lib
DLL	Dxva2.dll

Vedi anche

Funzioni OPM

Condividi tramite