Compartilhar via

Função OPMGetVideoOutputsFromHMONITOR (opmapi.h)

  • Artigo

Cria um objeto OPM (Output Protection Manager) para cada monitor físico associado a um identificador HMONITOR específico.

Sintaxe

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

Parâmetros

[in] hMonitor

O identificador do monitor para o qual criar objetos OPM. Há várias funções que retornam valores HMONITOR . Para obter mais informações, consulte o tópico Funções de vários monitores de exibição na documentação da GDI (interface de dispositivo gráfico) do Windows.

[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.

Valor retornado

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 identificador HMONITOR 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á a 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

   
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