Función OPMGetVideoOutputsFromIDirect3DDevice9Object (opmapi.h)

  • Artículo

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

Sintaxis

HRESULT OPMGetVideoOutputsFromIDirect3DDevice9Object(
  [in]  IDirect3DDevice9           *pDirect3DDevice9,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Parámetros

[in] pDirect3DDevice9

Puntero a la interfaz IDirect3DDevice9 de un dispositivo Direct3D.

[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 dispositivo Direct3D 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

Requisito Value
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