DXGKMDT_OPM_GET_INFO_PARAMETERS struttura (d3dkmdt.h)

  • Articolo

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

Vedi anche

DXGKMDT_OPM_OMAC

DXGKMDT_OPM_RANDOM_NUMBER

DxgkDdiOPMGetInformation

DxgkDdiOPMSetSigningKeyAndSequenceNumbers