estructura DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)
La estructura DXGKMDT_OPM_GET_INFO_PARAMETERS contiene parámetros que se usan para recuperar información de un objeto de salida protegido en una llamada a la función DxgkDdiOPMGetInformation .
Sintaxis
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;
Miembros
omac
Estructura de DXGKMDT_OPM_OMAC que contiene un código de autenticación de mensajes en modo de cifrado de clave única (CBC) para la autenticidad del mensaje. Para obtener más información sobre OMAC, consulte el algoritmo OMAC-1. Los parámetros OMAC-1 que usan OPM y COPP son:
E = AES (Estándar de cifrado avanzado)
t = 128 bits
K = La tecla de 128 bits que recibe el controlador de minipuerto de pantalla cuando se llama a DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
n = 128 bits
Para obtener información sobre AES, consulte el sitio web de RSA Laboratories .
rnRandomNumber
Estructura DXGKMDT_OPM_RANDOM_NUMBER que contiene un número aleatorio de 128 bits protegido del objeto de salida protegido. Una aplicación genera este número aleatorio y se proporciona al controlador de minipuerto de pantalla en rnRandomNumber en una llamada a la función DxgkDdiOPMGetInformation del controlador.
guidInformation
GUID que se usa para recuperar la información. guidInformation se puede establecer en uno de los siguientes GUID:
- 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. Compatible con Windows 7 y versiones posteriores.
- DXGKMDT_OPM_GET_OUTPUT_ID. Compatible con Windows 7 y versiones posteriores.
ulSequenceNumber
Número de secuencia. Para que la función DxgkDdiOPMGetInformation procese una solicitud de información, el valor de ulSequenceNumber debe coincidir con el número de secuencia de 4 bytes actual que almacena el controlador de miniporte para mostrar. Si no se detecta una coincidencia, DxgkDdiOPMGetInformation devuelve un código de error. Si se detecta una coincidencia, DxgkDdiOPMGetInformation incrementa el número de secuencia almacenado antes de devolver. El número de secuencia inicial de 4 bytes formaba parte de la matriz de 256 bytes a la que apuntaba el parámetro EncryptedParameters de la función DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
cbParametersSize
Tamaño, en bytes, de los datos válidos a los que apunta el miembro abParameters .
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Matriz de 4056 bytes que contiene los datos que acompañan a la solicitud de información identificada por el miembro guidInformation .
No se necesitan datos para las solicitudes de 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 y DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.
Las solicitudes de DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL y DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL requieren datos que identifiquen el tipo de protección para el que se solicita el nivel de protección. Por lo tanto, estas solicitudes requieren que los primeros 4 bytes de la matriz abParameters contengan el tipo de protección.
Comentarios
Todos los datos después de firmar el miembro omac en DXGKMDT_OPM_GET_INFO_PARAMETERS; la firma es OMAC y se almacena en el miembro omac . Los datos se firman mediante el algoritmo OMAC-1.
DXGKMDT_OPM_GET_INFO_PARAMETERS no se utiliza para la emulación COPP; en su lugar, la estructura DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS se usa para COPP.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Encabezado | d3dkmdt.h |