struttura OPM_GET_INFO_PARAMETERS (ksopmapi.h)

Contiene i 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[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

Members

omac

Struttura OPM_OMAC che contiene un codice mac (Message Authentication Code) per i dati nel resto della struttura.

rnRandomNumber

Struttura OPM_RANDOM_NUMBER che contiene un numero casuale a 128 bit protetto da 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 conteggio in esecuzione delle richieste di stato. Per ogni richiesta, incrementare il numero di sequenza di 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 incrementare ulSequenceNumber di 1.

Eccezione: se la richiesta di stato non riesce, non incrementare 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[OPM_GET_INFORMATION_PARAMETERS_SIZE]

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 segue:

  1. Generare un numero casuale a 128 bit protetto da crittografia e copiarlo nel membro rnRandomNumber . Non riutilizzare questo numero dopo aver chiamato GetInformation.
  2. Compilare i membri della struttura rimanenti, ad eccezione del membro omac .
  3. Usare l'algoritmo OMAC 1 per calcolare un codice mac (Message Authentication Code) per il blocco di dati visualizzato dopo il membro omac (escluso il membro omac ).
  4. Copiare il MAC nel membro omac .

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione ksopmapi.h (include Opmapi.h)

Vedi anche

Strutture OPM

Output Protection Manager