Fonction OPMGetVideoOutputsFromHMONITOR (opmapi.h)

  • Article

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