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.
- Füllen Sie alle Strukturmember mit Ausnahme des omac-Elements aus.
- 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 ).
- 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 |