OPM_CONFIGURE_PARAMETERS-Struktur (opmapi.h)

Enthält einen OPM-Befehl (Output Protection Manager ) oder einen COPP-Befehl (Certified Output Protection Manager).

Syntax

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

Member

omac

Eine OPM_MAC-Struktur . Füllen Sie diese Struktur mit dem Nachrichtenauthentifizierungscode (Message Authentication Code, MAC) der Befehlsdaten aus. Verwenden Sie AES-basiertes CBC MAC (OMAC) mit einem Schlüssel, um diesen Wert zu berechnen.

guidSetting

Eine GUID, die den Befehl angibt. Weitere Informationen finden Sie unter OPM-Befehle.

ulSequenceNumber

Eine Befehlssequenznummer. Die Anwendung muss die Anzahl der ausgeführten Befehle beibehalten. Erhöhen Sie für jeden Befehl die Sequenznummer um eins.

Legen Sie beim ersten Aufruf von IOPMVideoOutput::ConfigureulSequenceNumber gleich der Startbefehlssequenznummer fest, die angegeben wird, wenn die Anwendung IOPMVideoOutput::FinishInitialization aufruft. Erhöhen Sie bei jedem nachfolgenden Aufruf ulSequenceNumber um 1.

Ausnahme: Wenn die IOPMVideoOutput::Configure-Methode fehlschlägt, erhöhen Sie die Sequenznummer nicht. Verwenden Sie stattdessen die gleiche Zahl für den nächsten Befehl.

cbParametersSize

Die Anzahl der Byte gültiger Daten im abParameters-Element .

abParameters[4056]

Die Daten für den Befehl. Die Bedeutung der Daten hängt vom Befehl ab. Weitere Informationen finden Sie unter OPM-Befehle.

Hinweise

Das Layout dieser Struktur ist identisch mit der AMCOPPCommand-Struktur , die in Certified Output Protection Protocol (COPP) verwendet wird.

Initialisieren Sie diese Struktur wie folgt.

1. Füllen Sie alle Strukturmember mit Ausnahme des omac-Elements aus.
2. Verwenden Sie den OMAC 1-Algorithmus, um einen Nachrichtenauthentifizierungscode (MAC) für den Datenblock zu berechnen, der nach dem omac-Element angezeigt wird (mit Ausnahme des omac-Elements ).
3. Kopieren Sie den MAC in das omac-Element .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	opmapi.h

Weitere Informationen

IOPMVideoOutput::Configure

OPM-Strukturen

Ausgabeschutz-Manager