OPM_CONFIGURE_PARAMETERS struttura (opmapi.h)

Contiene un comando OPM ( Output Protection Manager ) o Certificateed Output Protection Manager (COPP).

Sintassi

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

Members

omac

Struttura OPM_MAC . Compilare questa struttura con il codice di autenticazione dei messaggi (MAC) dei dati del comando. Usare CBC MAC (OMAC) basato su AES per calcolare questo valore.

guidSetting

GUID che specifica il comando. Per altre informazioni, vedere Comandi OPM.

ulSequenceNumber

Numero di sequenza di comandi. L'applicazione deve mantenere un conteggio in esecuzione dei comandi emessi. Per ogni comando, aumentare il numero di sequenza per uno.

Nella prima chiamata a IOPMVideoOutput::Configure impostare ulSequenceNumber uguale al numero di sequenza di comandi iniziale, specificato quando l'applicazione chiama IOPMVideoOutput::FinishInitialization. In ogni chiamata successiva aumentare ulSequenceNumber by 1.

Eccezione: se il metodo IOPMVideoOutput::Configure ha esito negativo, non aumentare il numero di sequenza. Usare invece lo stesso numero per il comando successivo.

cbParametersSize

Numero di byte di dati validi nel membro abParameters .

abParameters[4056]

Dati per il comando. Il significato dei dati dipende dal comando. Per altre informazioni, vedere Comandi OPM.

Commenti

Il layout di questa struttura è identico alla struttura AMCOPPCommand usata in Certified Output Protection Protocol (COPP).

Inizializzare questa struttura come indicato di seguito.

1. Compilare tutti i membri della struttura, ad eccezione del membro omac .
2. Usare l'algoritmo OMAC 1 per calcolare un codice di autenticazione dei messaggi (MAC) per il blocco di dati visualizzato dopo il membro omac (escluso il membro omac ).
3. Copiare il MAC nel membro omac .

Requisiti

Vedi anche

IOPMVideoOutput::Configure

Strutture OPM

Output Protection Manager