Fonction OPMGetVideoOutputsFromHMONITOR (opmapi.h)

Article
08/25/2023

Crée un objet Output Protection Manager (OPM) pour chaque moniteur physique associé à un handle HMONITOR particulier.

Syntaxe

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

Paramètres

[in] hMonitor

Handle de moniteur pour lequel créer des objets OPM. Plusieurs fonctions retournent des valeurs HMONITOR . Pour plus d’informations, consultez la rubrique Fonctions de moniteurs d’affichage multiples dans la documentation de l’interface des périphériques graphiques (GDI) Windows.

[in] vos

Membre de l’énumération OPM_VIDEO_OUTPUT_SEMANTICS .

Valeur	Signification
OPM_VOS_OPM_SEMANTICS	Les pointeurs IOPMVideoOutput retournés utilisent la sémantique OPM.
OPM_VOS_COPP_SEMANTICS	Les pointeurs IOPMVideoOutput retournés utilisent la sémantique COPP (Certified Output Protection Protocol).

[out] pulNumVideoOutputs

Reçoit le nombre de pointeurs IOPMVideoOutput retournés dans le paramètre pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Reçoit un pointeur vers un tableau de pointeurs IOPMVideoOutput . Chaque pointeur IOPMVideoOutput est associé à un seul moniteur physique. L’appelant doit libérer chaque pointeur dans le tableau et appeler CoTaskMemFree pour libérer le tableau.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Un seul handle HMONITOR peut être associé à plusieurs moniteurs physiques. Chaque moniteur physique a son propre connecteur. L’application doit définir le mécanisme de protection individuellement pour chaque moniteur physique, à l’aide des pointeurs IOPMVideoOutput retournés dans pppOPMVideoOutputArray.

L’interface IOPMVideoOutput a deux modes de comportement, en fonction de la valeur du paramètre vos . Si vos est OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput utilise la sémantique COPP. Ce mode est destiné à la compatibilité descendante avec COPP. Si vos est OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput utilise la sémantique OPM la plus récente. Les différences de comportement sont notées sur la page de référence pour chaque méthode. Le mode ne change pas pendant la durée de vie de l’objet.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	opmapi.h
Bibliothèque	Dxva2.lib
DLL	Dxva2.dll

Voir aussi

Fonctions OPM

Partager via