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:
- Generare un numero casuale a 128 bit protetto da 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 mac (Message Authentication Code) per il blocco di dati visualizzato dopo il membro omac (escluso il membro omac ).
- 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) |