Compartilhar via


Método IOPMVideoOutput::Configure (opmapi.h)

Configura uma saída de vídeo. Esse método envia um comando OPM (Output Protection Manager) ou COPP (Certified Output Protection Protocol) para o driver.

Sintaxe

HRESULT Configure(
  [in] const OPM_CONFIGURE_PARAMETERS *pParameters,
  [in] ULONG                          ulAdditionalParametersSize,
  [in] const BYTE                     *pbAdditionalParameters
);

Parâmetros

[in] pParameters

Ponteiro para uma estrutura OPM_CONFIGURE_PARAMETERS que contém o comando . Para obter uma lista de comandos OPM, consulte Comandos OPM.

[in] ulAdditionalParametersSize

O tamanho do buffer pbAdditionalParameters , em bytes.

[in] pbAdditionalParameters

Ponteiro para um buffer que contém informações adicionais para o comando.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é equivalente ao método IAMCertifiedOutputProtection::P rotectionCommand no COPP.

Esse método dá suporte à semântica do OPM e à semântica copp. Há suporte para semântica copp para compatibilidade com versões anteriores; os novos aplicativos devem usar a semântica do OPM.

Semântica do OPM

Alguns comandos OPM exigem que informações de configuração adicionais sejam passadas no parâmetro pbAdditionalParameters . O parâmetro ulAdditionalParametersSize especifica o tamanho dos dados adicionais.

Semântica copp

O parâmetro pbAdditionalParameters deve ser NULL e ulAdditionalParametersSize deve ser zero.

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

Confira também

IOPMVideoOutput

Gerenciador de Proteção de Saída