Compartir a través de

Función OPMGetVideoOutputsFromHMONITOR (opmapi.h)

  • Artículo

Crea un objeto del Administrador de protección de salida (OPM) para cada monitor físico asociado a un identificador HMONITOR determinado.

Sintaxis

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

Parámetros

[in] hMonitor

Identificador de monitor para el que se van a crear objetos OPM. Hay varias funciones que devuelven valores HMONITOR . Para obtener más información, vea el tema Funciones de varios monitores de visualización en la documentación de la interfaz de dispositivo gráfico (GDI) de Windows.

[in] vos

Miembro de la enumeración OPM_VIDEO_OUTPUT_SEMANTICS .

Valor Significado
OPM_VOS_OPM_SEMANTICS
 Los punteros IOPMVideoOutput devueltos usarán la semántica de OPM.
OPM_VOS_COPP_SEMANTICS
 Los punteros IOPMVideoOutput devueltos usarán la semántica del Protocolo de protección de salida certificada (COPP).

[out] pulNumVideoOutputs

Recibe el número de punteros IOPMVideoOutput devueltos en el parámetro pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Recibe un puntero a una matriz de punteros IOPMVideoOutput . Cada puntero IOPMVideoOutput está asociado a un único monitor físico. El autor de la llamada debe liberar cada puntero de la matriz y llamar a CoTaskMemFree para liberar la matriz.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Un único identificador HMONITOR se puede asociar a varios monitores físicos. Cada monitor físico tiene su propio conector. La aplicación debe establecer el mecanismo de protección individualmente para cada monitor físico, mediante los punteros IOPMVideoOutput devueltos en pppOPMVideoOutputArray.

La interfaz IOPMVideoOutput tiene dos modos de comportamiento, dependiendo del valor del parámetro vos . Si vos es OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput usa la semántica de COPP. Este modo está pensado para la compatibilidad con versiones anteriores con COPP. Si vos es OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput usa la semántica de OPM más reciente. Las diferencias en el comportamiento se indican en la página de referencia de cada método. El modo no cambia durante la vigencia del objeto.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado opmapi.h
Library Dxva2.lib
Archivo DLL Dxva2.dll

Consulte también

Funciones de OPM