DXGKMDT_OPM_GET_INFO_PARAMETERS struttura (d3dkmdt.h)
La struttura DXGKMDT_OPM_GET_INFO_PARAMETERS contiene parametri usati per recuperare informazioni da un oggetto di output protetto in una chiamata alla funzione DxgkDdiOPMGetInformation .
Sintassi
typedef struct _DXGKMDT_OPM_GET_INFO_PARAMETERS {
DXGKMDT_OPM_OMAC omac;
DXGKMDT_OPM_RANDOM_NUMBER rnRandomNumber;
GUID guidInformation;
ULONG ulSequenceNumber;
ULONG cbParametersSize;
BYTE abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE];
} DXGKMDT_OPM_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_GET_INFO_PARAMETERS;
Members
omac
Struttura DXGKMDT_OPM_OMAC che contiene un codice di autenticazione del messaggio in modalità One-Key Block Chaining (CBC)-mode message authentication code (OMAC) per l'autenticazione dei messaggi. Per altre informazioni su OMAC, vedere l'algoritmo OMAC-1. I parametri OMAC-1 usati da OPM e COPP sono:
E = AES (Advanced Encryption Standard)
t = 128 bit
K = Chiave a 128 bit ricevuta dal driver miniport visualizzato quando viene chiamato DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
n = 128 bit
Per informazioni su AES, vedere il sito Web RSA Labss .
rnRandomNumber
Struttura DXGKMDT_OPM_RANDOM_NUMBER che contiene un oggetto di output protetto a 128 bit numero casuale. Questo numero casuale viene generato da un'applicazione e fornito al driver miniport visualizzato in rnRandomNumber in una chiamata alla funzione DxgkDdiOPMGetInformation del driver.
guidInformation
GUID usato per recuperare le informazioni. guidInformation può essere impostato su uno dei GUID seguenti:
- DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION
- DXGKMDT_OPM_GET_CONNECTOR_TYPE
- DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES
- DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT
- DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE
- DXGKMDT_OPM_GET_DVI_CHARACTERISTICS. Supportato in Windows 7 e versioni successive.
- DXGKMDT_OPM_GET_OUTPUT_ID. Supportato in Windows 7 e versioni successive.
ulSequenceNumber
Numero di sequenza. Per la funzione DxgkDdiOPMGetInformation per elaborare una richiesta di informazioni, il valore in ulSequenceNumber deve corrispondere al numero di sequenza 4 byte corrente archiviato dal driver miniport visualizzato. Se non viene rilevata una corrispondenza, DxgkDdiOPMGetInformation restituisce un codice di errore. Se viene rilevata una corrispondenza, DxgkDdiOPMGetInformation incrementa il numero di sequenza archiviato prima di restituire. Il numero di sequenza 4 byte iniziale fa parte della matrice a 256 byte a cui punta il parametro EncryptedParameters della funzione DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
cbParametersSize
Dimensioni, in byte, dei dati validi a cui punta il membro abParameters .
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Matrice di 4056 byte che contiene i dati che accompagnano la richiesta di informazioni identificata dal membro guidInformation .
Non sono necessari dati per le richieste di DXGKMDT_OPM_GET_CONNECTOR_TYPE, DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES, DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE, DXGKMDT_OPM_GET_DVI_CHARACTERISTICS, DXGKMDT_OPM_GET_OUTPUT_ID e DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.
Le richieste di DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL e DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL richiedono dati che identificano il tipo di protezione richiesto dal livello di protezione. Pertanto, queste richieste richiedono che i primi 4 byte nella matrice abParameters contengano il tipo di protezione.
Commenti
Tutti i dati dopo la firma del membro omac in DXGKMDT_OPM_GET_INFO_PARAMETERS; la firma è OMAC e viene archiviata nel membro omac . I dati sono firmati usando l'algoritmo OMAC-1.
DXGKMDT_OPM_GET_INFO_PARAMETERS non viene usato per l'emulazione COPP; la struttura DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS viene invece usata per COPP.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Intestazione | d3dkmdt.h |