структура DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)
Структура DXGKMDT_OPM_GET_INFO_PARAMETERS содержит параметры, которые используются для получения сведений из защищенного выходного объекта при вызове функции DxgkDdiOPMGetInformation .
Синтаксис
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;
Члены
omac
Структура DXGKMDT_OPM_OMAC , содержащая код проверки подлинности сообщений (OMAC) в режиме CBC для проверки подлинности сообщений. Дополнительные сведения об OMAC см. в разделе Алгоритм OMAC-1. Параметры OMAC-1, используемые OPM и COPP:
E = AES (расширенный стандарт шифрования)
t = 128 бит
K = 128-разрядный ключ, который драйвер мини-порта дисплея получает при вызове DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
n = 128 бит
Сведения об AES см. на веб-сайте RSA Laboratories .
rnRandomNumber
Структура DXGKMDT_OPM_RANDOM_NUMBER , содержащая 128-разрядное случайное число защищенного криптографически защищенного объекта вывода. Это случайное число создается приложением и предоставляется драйверу мини-порта для отображения в rnRandomNumber при вызове функции DxgkDdiOPMGetInformation драйвера.
guidInformation
GUID, используемый для получения сведений. GuidInformation можно задать для одного из следующих идентификаторов 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. Поддерживается в Windows 7 и более поздних версиях.
- DXGKMDT_OPM_GET_OUTPUT_ID. Поддерживается в Windows 7 и более поздних версиях.
ulSequenceNumber
Порядковый номер. Чтобы функция DxgkDdiOPMGetInformation обрабатывала запрос информации, значение в ulSequenceNumber должно соответствовать текущему 4-байтового порядкового номера, который хранит драйвер мини-порта дисплея. Если совпадение не обнаружено, DxgkDdiOPMGetInformation возвращает код ошибки. При обнаружении совпадения DxgkDdiOPMGetInformation увеличивает хранимый порядковый номер перед возвратом. Первоначальный 4-байтовый порядковый номер был частью 256-байтового массива, на который указывал параметр EncryptedParameters функции DxgkDdiOPMSetSigningKeyAndSequenceNumbers .
cbParametersSize
Размер допустимых данных, на которые указывает член abParameters (в байтах ).
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
4056-байтовый массив, содержащий данные, сопровождающие запрос информации, идентифицируемый элементом guidInformation .
Данные не требуются для запросов 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 и DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.
Запросы DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL и DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL требуют данных, определяющих тип защиты, для которых запрашивается уровень защиты. Таким образом, для этих запросов требуется, чтобы первые 4 байта в массиве abParameters содержали тип защиты.
Комментарии
Все данные после подписи члена omac в DXGKMDT_OPM_GET_INFO_PARAMETERS; сигнатурой является OMAC и хранится в элементе omac . Данные подписываются с помощью алгоритма OMAC-1.
DXGKMDT_OPM_GET_INFO_PARAMETERS не используется для эмуляции COPP; Вместо этого для COPP используется структура DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Верхняя часть | d3dkmdt.h |