Função OPMGetVideoOutputsFromIDirect3DDevice9Object (opmapi.h)

  • Artigo

Cria um objeto OPM (Output Protection Manager) para cada monitor físico associado a um determinado dispositivo Direct3D.

Sintaxe

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

Parâmetros

[in] pDirect3DDevice9

Ponteiro para a interface IDirect3DDevice9 de um dispositivo Direct3D.

[in] vos

Um membro da enumeração OPM_VIDEO_OUTPUT_SEMANTICS .

Valor Significado
OPM_VOS_OPM_SEMANTICS
 Os ponteiros IOPMVideoOutput retornados usarão a semântica do OPM.
OPM_VOS_COPP_SEMANTICS
 Os ponteiros IOPMVideoOutput retornados usarão a semântica COPP (Certified Output Protection Protocol).

[out] pulNumVideoOutputs

Recebe o número de ponteiros IOPMVideoOutput retornados no parâmetro pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Recebe um ponteiro para uma matriz de ponteiros IOPMVideoOutput . Cada ponteiro IOPMVideoOutput é associado a um único monitor físico. O chamador deve liberar cada ponteiro na matriz e chamar CoTaskMemFree para liberar a matriz.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Um único dispositivo Direct3D pode ser associado a vários monitores físicos. Cada monitor físico tem seu próprio conector. O aplicativo deve definir o mecanismo de proteção individualmente para cada monitor físico, usando os ponteiros IOPMVideoOutput retornados em pppOPMVideoOutputArray.

A interface IOPMVideoOutput tem dois modos de comportamento, dependendo do valor do parâmetro vos . Se vos for OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput usará semântica COPP. Esse modo destina-se à compatibilidade com versões anteriores com COPP. Se vos for OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput usará a semântica OPM mais recente. As diferenças de comportamento são observadas na página de referência de cada método. O modo não é alterado durante o tempo de vida do objeto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho opmapi.h
Biblioteca Dxva2.lib
DLL Dxva2.dll

Confira também

Funções OPM