estrutura DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)
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çãoDxgkDdiOPMGetInformation.
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 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 é chamada.
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 criptograficamente seguro 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 deDxgkDdiOPMGetInformationdo 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 a função DxgkDdiOPMGetInformation para processar 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 de sequência inicial 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 aos quais os abParameters membro 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 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 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 no abParameters matriz contenham o tipo de proteção.
Observações
Todos os dados após a assinatura do membro do 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| cabeçalho | d3dkmdt.h |