estructura DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Artículo
03/08/2023

La estructura DXGKMDT_OPM_CONFIGURE_PARAMETERS contiene parámetros que se usan para configurar un objeto de salida protegido en una llamada a la función DxgkDdiOPMConfigureProtectedOutput .

Sintaxis

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;

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 miniporte de pantalla cuando se llama a DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

n = 128 bits

Para obtener información sobre AES, consulte el sitio web de RSA Laboratories .

guidSetting

GUID que se usa para configurar el objeto de salida protegido. guidSetting se puede establecer en uno de los siguientes 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. Compatible con Windows 7 y versiones posteriores.

ulSequenceNumber

Número de secuencia. Para que la función DxgkDdiOPMConfigureProtectedOutput procese una solicitud de configuració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, DxgkDdiOPMConfigureProtectedOutput devuelve un código de error. Si se detecta una coincidencia, DxgkDdiOPMConfigureProtectedOutput incrementa el número de secuencia almacenado antes de devolverlo. El número de secuencia inicial de 4 bytes forma parte de la matriz de 256 bytes a la que apunta el parámetro EncryptedParameters de la función DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

cbParametersSize

Tamaño, en bytes, de los datos de configuración válidos a los que apunta el miembro abParameters .

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Matriz de 4056 bytes que especifica cómo configurar el objeto de salida protegido.

El parámetro abParameters se convierte en una de las siguientes estructuras que contiene la información de configuración, según el GUID especificado en el miembro guidSetting de DXGKMDT_OPM_CONFIGURE_PARAMETERS a los que apunta el parámetro Parameters de DxgkDdiOPMConfigureProtectedOutput .

Estos son los GUID y estructuras posibles para la información de configuración:

GUID	Estructura para la información recuperada
DXGKMDT_OPM_SET_PROTECTION_LEVEL o 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