estrutura DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Artigo
02/06/2025

A estrutura DXGKMDT_OPM_CONFIGURE_PARAMETERS contém parâmetros usados para configurar um objeto de saída protegido em uma chamada para a funçãoDxgkDdiOPMConfigureProtectedOutput.

Sintaxe

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;

Membros

omac

Uma estrutura de DXGKMDT_OPM_OMAC que contém um código de autenticação de mensagem do modo CBC (Encadeamento de Blocos de Criptografia) de uma chave para autenticidade da mensagem. Para obter mais informações sobre o OMAC, consulte o algoritmo OMAC-1 . Os parâmetros OMAC-1 que o OPM e o COPP usam são:

E = AES (Advanced Encryption Standard)

t = 128 bits

K = A chave de 128 bits que o driver de miniporto de exibição recebe quando DxgkDdiOPMSetSigningKeyAndSequenceNumbers é chamado.

n = 128 bits

Para obter informações sobre o AES, consulte o site do RSA Laboratories.

guidSetting

O GUID usado para configurar o objeto de saída protegido. guidSetting pode ser definido como um dos seguintes GUIDs:

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. Com suporte no Windows 7 e versões posteriores.

ulSequenceNumber

Um número de sequência. Para a funçãoDxgkDdiOPMConfigureProtectedOutput para processar uma solicitação de configuração, o valor em ulSequenceNumber deve corresponder ao número de sequência atual de 4 bytes que o driver de miniporto de exibição armazena. Se uma correspondência não for detectada, DxgkDdiOPMConfigureProtectedOutput retornará um código de erro. Se uma correspondência for detectada, DxgkDdiOPMConfigureProtectedOutput incrementará o número de sequência armazenado antes de retornar. O número de sequência inicial de 4 bytes faz parte da matriz de 256 bytes à qual o parâmetro EncryptedParameters do dxgkDdiOPMSetSigningKeyAndSequenceNumbers aponta para a função.

cbParametersSize

O tamanho, em bytes, dos dados de configuração válidos aos quais os abParameters membro aponta.

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Uma matriz de 4056 bytes que especifica como configurar o objeto de saída protegido.

O parâmetro abParameters é convertido em uma das seguintes estruturas que contém as informações de configuração, dependendo do GUID especificado no guidSetting membro de DXGKMDT_OPM_CONFIGURE_PARAMETERS que o parâmetro Parâmetros de DxgkDdiOPMConfigureProtectedOutput aponta.

Estes são possíveis GUIDs e estruturas para obter informações de configuração:

GUID	Estrutura para informações recuperadas
DXGKMDT_OPM_SET_PROTECTION_LEVEL ou 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