OPM_GET_INFO_PARAMETERS-Struktur (ksopmapi.h)

Enthält Parameter für die IOPMVideoOutput::GetInformation-Methode .

Syntax

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

Members

omac

Eine OPM_OMAC Struktur, die einen Nachrichtenauthentifizierungscode (Mac) für die Daten im Rest der Struktur enthält.

rnRandomNumber

Eine OPM_RANDOM_NUMBER Struktur, die eine kryptografisch sichere 128-Bit-Zufallszahl enthält.

guidInformation

Eine GUID, die die status Anforderung definiert. Weitere Informationen finden Sie unter OPM-Statusanforderungen.

ulSequenceNumber

Die status Sequenznummer. Die Anwendung muss die Anzahl der ausgeführten status Anforderungen beibehalten. Erhöhen Sie für jede Anforderung die Sequenznummer um 1.

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

Ausnahme: Wenn die status-Anforderung fehlschlägt, erhöhen Sie die Sequenznummer nicht. Verwenden Sie stattdessen dieselbe Nummer für die nächste status-Anforderung.

cbParametersSize

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

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

Die Daten für die status-Anforderung. Die Bedeutung der Daten hängt von der Anforderung ab. Weitere Informationen finden Sie unter OPM-Statusanforderungen.

Hinweise

Initialisieren Sie diese Struktur wie folgt:

1. Generieren Sie eine kryptografisch sichere 128-Bit-Zufallszahl, und kopieren Sie sie in das element rnRandomNumber . Verwenden Sie diese Nummer nach dem Aufruf von GetInformation nicht erneut.
2. Füllen Sie die verbleibenden Strukturmember mit Ausnahme des omac-Elements aus.
3. 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 ).
4. Kopieren Sie den MAC in das omac-Element .

Anforderungen

Weitere Informationen

OPM-Strukturen

Ausgabeschutz-Manager