структура DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Статья
02/06/2025

Структура DXGKMDT_OPM_CONFIGURE_PARAMETERS содержит параметры, используемые для настройки защищенного выходного объекта в вызове функции DxgkDdiOPMConfigureProtectedOutput.

Синтаксис

typedef struct _DXGKMDT_OPM_CONFIGURE_PARAMETERS {
  DXGKMDT_OPM_OMAC omac;
  GUID             guidSetting;
  ULONG            ulSequenceNumber;
  ULONG            cbParametersSize;
  BYTE             abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE];
} DXGKMDT_OPM_CONFIGURE_PARAMETERS, *PDXGKMDT_OPM_CONFIGURE_PARAMETERS;

Члены

omac

Структура DXGKMDT_OPM_OMAC, содержащая код проверки подлинности сообщений в режиме CBC (OMAC) с одно ключом. Дополнительные сведения об OMAC см. в алгоритме OMAC-1. Параметры OMAC-1, используемые OPM и COPP, являются следующими:

E = AES (расширенный стандарт шифрования)

t = 128 бит

K = 128-разрядный ключ, который получает драйвер мини-порта отображения, когда вызывается dxgkDdiOPMSetSigningKeyAndSequenceNumbers.

n = 128 бит

Дополнительные сведения об AES см. на веб-сайте лабораторий RSA.

guidSetting

GUID, используемый для настройки защищенного выходного объекта. guidSetting можно задать для одного из следующих идентификаторов GUID:

DXGKMDT_OPM_SET_PROTECTION_LEVEL
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING
DXGKMDT_OPM_SET_HDCP_SRM
DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD. Поддерживается в Windows 7 и более поздних версиях.

ulSequenceNumber

Порядковый номер. Чтобы функция dxgkDdiOPMConfigureProtectedOutput для обработки запроса на настройку, значение в ulSequenceNumber должно соответствовать текущему 4-байтового порядкового номера, в котором хранится драйвер мини-порта отображения. Если совпадение не обнаружено, DxgkDdiOPMConfigureProtectedOutput возвращает код ошибки. Если обнаружено совпадение, DxgkDdiOPMConfigureProtectedOutput увеличивает хранимый номер последовательности перед возвратом. Начальный 4-байтовый порядковый номер является частью массива 256-байтов, на который указывает параметр EncryptedParameters параметра DxgkDdiOPMSetSigningKeyAndSequenceNumbers.

cbParametersSize

Размер в байтах допустимых данных конфигурации, на которые указывает abParameters член.

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Массив 4056-байтов, указывающий, как настроить защищенный выходной объект.

Параметр abParameters приводится к одной из следующих структур, содержащих сведения о конфигурации, в зависимости от GUID, указанного в элементе guidSetting DXGKMDT_OPM_CONFIGURE_PARAMETERS , к которому указывает параметр параметров DxgkDdiOPMConfigureProtectedOutput.

Это возможные идентификаторы GUID и структуры для сведений о конфигурации:

GUID	Структура для полученных сведений
DXGKMDT_OPM_SET_PROTECTION_LEVEL или DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD	DXGKMDT_OPM_SET_PROTECTION_LEVEL_PARAMETERS
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING	DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
DXGKMDT_OPM_SET_HDCP_SRM	DXGKMDT_OPM_SET_HDCP_SRM_PARAMETERS