estrutura OPM_CONFIGURE_PARAMETERS (opmapi.h)

  • Artigo

Contém um comando OPM ( Output Protection Manager ) ou COPP (Certified Output Protection Manager).

Sintaxe

typedef struct _OPM_CONFIGURE_PARAMETERS {
  OPM_OMAC omac;
  GUID     guidSetting;
  ULONG    ulSequenceNumber;
  ULONG    cbParametersSize;
  BYTE     abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;

Membros

omac

Uma estrutura OPM_MAC . Preencha essa estrutura com o MAC (Código de Autenticação de Mensagem) dos dados de comando. Use o CBC MAC (OMAC) baseado em AES para calcular esse valor.

guidSetting

Um GUID que especifica o comando . Para obter mais informações, consulte Comandos OPM.

ulSequenceNumber

Um número de sequência de comandos. O aplicativo deve manter uma contagem em execução dos comandos emitidos. Para cada comando, incremente o número da sequência em um.

Na primeira chamada para IOPMVideoOutput::Configure, defina ulSequenceNumber igual ao número de sequência de comandos inicial, que é especificado quando o aplicativo chama IOPMVideoOutput::FinishInitialization. Em cada chamada subsequente, incremente ulSequenceNumber em 1.

Exceção: se o método IOPMVideoOutput::Configure falhar, não incremente o número da sequência. Em vez disso, reutilize o mesmo número para o próximo comando.

cbParametersSize

O número de bytes de dados válidos no membro abParameters .

abParameters[4056]

Os dados do comando. O significado dos dados depende do comando . Para obter mais informações, consulte Comandos OPM.

Comentários

O layout dessa estrutura é idêntico à estrutura AMCOPPCommand usada no COPP (Certified Output Protection Protocol).

Inicialize essa estrutura da seguinte maneira.

  1. Preencha todos os membros da estrutura, exceto o membro omac .
  2. Use o algoritmo OMAC 1 para calcular um MAC (código de autenticação de mensagem) para o bloco de dados que aparece após o membro omac (excluindo o membro omac ).
  3. Copie o MAC para o membro omac .

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]
Cabeçalho opmapi.h

Confira também

IOPMVideoOutput::Configure

Estruturas OPM

Gerenciador de Proteção de Saída