estrutura DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Artigo
02/23/2024

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ção DxgkDdiOPMConfigureProtectedOutput .

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 Criptografia de Codificação de Uma Chave) (OMAC) 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 que a função DxgkDdiOPMConfigureProtectedOutput processe 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 para a qual o parâmetro EncryptedParameters da função DxgkDdiOPMSetSigningKeyAndSequenceNumbers aponta para.

cbParametersSize

O tamanho, em bytes, dos dados de configuração válidos para os quais o membro abParameters 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 estruturas a seguir que contém as informações de configuração, dependendo do GUID especificado no membro guidSetting de DXGKMDT_OPM_CONFIGURE_PARAMETERS para o qual o parâmetro Parameters de DxgkDdiOPMConfigureProtectedOutput aponta para.

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

GUID	Estrutura para obter 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