estrutura DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)

Artigo
03/08/2023

A estrutura DXGKMDT_OPM_GET_INFO_PARAMETERS contém parâmetros usados para recuperar informações de um objeto de saída protegido em uma chamada para a função DxgkDdiOPMGetInformation .

Sintaxe

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;

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 .

rnRandomNumber

Uma estrutura DXGKMDT_OPM_RANDOM_NUMBER que contém o número aleatório de segurança criptograficamente de 128 bits de um objeto de saída protegido. Esse número aleatório é gerado por um aplicativo e fornecido ao driver de miniporto de exibição em rnRandomNumber em uma chamada para a função DxgkDdiOPMGetInformation do driver.

guidInformation

O GUID usado para recuperar as informações. guidInformation pode ser definido como um dos seguintes GUIDs:

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

ulSequenceNumber

Um número de sequência. Para que a função DxgkDdiOPMGetInformation processe uma solicitação de informações, 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, DxgkDdiOPMGetInformation retornará um código de erro. Se uma correspondência for detectada, DxgkDdiOPMGetInformation incrementará o número de sequência armazenado antes de retornar. O número inicial da sequência de 4 bytes fazia parte da matriz de 256 bytes que o parâmetro EncryptedParameters da função DxgkDdiOPMSetSigningKeyAndSequenceNumbers apontou.

cbParametersSize

O tamanho, em bytes, dos dados válidos para os quais o membro abParameters aponta.

abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]

Uma matriz de 4056 bytes que contém os dados que acompanham a solicitação de informações identificada pelo membro guidInformation .

Nenhum dado é necessário para as solicitações de 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 e DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.

As solicitações de DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL e DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL exigem dados que identificam o tipo de proteção para o qual o nível de proteção é solicitado. Portanto, essas solicitações exigem que os primeiros 4 bytes na matriz abParameters contenham o tipo de proteção.

Comentários

Todos os dados após a assinatura do membro omac no DXGKMDT_OPM_GET_INFO_PARAMETERS; a assinatura é o OMAC e é armazenada no membro omac . Os dados são assinados usando o algoritmo OMAC-1.

DXGKMDT_OPM_GET_INFO_PARAMETERS não é usado para emulação copp; em vez disso, a estrutura DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS é usada para COPP.