OPM_GET_INFO_PARAMETERS struttura (opmapi.h)

Articolo
03/01/2024

Contiene parametri per il metodo IOPMVideoOutput::GetInformation .

Sintassi

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

Members

omac

Struttura OPM_OMAC contenente un codice di autenticazione dei messaggi (MAC) per i dati nel resto della struttura.

rnRandomNumber

Struttura OPM_RANDOM_NUMBER contenente un numero casuale a 128 bit di crittografia.

guidInformation

GUID che definisce la richiesta di stato. Per altre informazioni, vedere Richieste di stato OPM.

ulSequenceNumber

Numero di sequenza di stato. L'applicazione deve mantenere un numero di richieste di stato in esecuzione. Per ogni richiesta, aumentare il numero di sequenza per 1.

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

Eccezione: se la richiesta di stato ha esito negativo, non aumentare il numero di sequenza. Usare invece di nuovo lo stesso numero per la richiesta di stato successiva.

cbParametersSize

Numero di byte di dati validi nel membro abParameters .

abParameters[4056]

Dati per la richiesta di stato. Il significato dei dati dipende dalla richiesta. Per altre informazioni, vedere Richieste di stato OPM.

Commenti

Inizializzare questa struttura come indicato di seguito:

Generare un numero casuale a 128 bit di crittografia e copiarlo nel membro rnRandomNumber . Non riutilizzare questo numero dopo aver chiamato GetInformation.
Compilare i membri della struttura rimanenti, ad eccezione del membro omac .
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 ).
Copiare il MAC nel membro omac .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	opmapi.h (includere Opmapi.h)

Vedi anche

Strutture OPM

Output Protection Manager

Condividi tramite