DXGKDDI_OPM_GET_CERTIFICATE_SIZE função de retorno de chamada (dispmprt.h)

Artigo
02/06/2025

A função DxgkDdiOPMGetCertificateSize recupera o tamanho de um certificado do tipo fornecido.

Sintaxe

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

Parâmetros

[in] MiniportDeviceContext

Um identificador para um bloco de contexto associado a um adaptador de exibição. Anteriormente, a função DxgkDdiAddDevice do driver de miniporto de exibição forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] CertificateType

Um valor DXGKMDT_CERTIFICATE_TYPEdigitado que identifica o tipo de certificado cujo tamanho DxgkDdiOPMGetCertificateSize retorna.

[out] CertificateSize

Um ponteiro para uma variável que recebe o tamanho, em bytes, do certificado cujo tipo é identificado pelo valor no parâmetro CertificateType.

Valor de retorno

DxgkDdiOPMGetCertificateSize retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função recuperou com êxito o tamanho do certificado.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	O driver de miniporto de exibição não dá suporte ao OPM porque o fornecedor de hardware nunca assinou o contrato de licença do OPM ou o hardware gráfico do driver de miniport não está em conformidade com as regras do OPM. DxgkDdiOPMGetCertificateSize também poderá retornar esse valor se o driver de miniporto de exibição detectou adulteração.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	O driver de miniporto de exibição não dá suporte ao COPP porque o fornecedor de hardware nunca assinou o contrato de licença copp ou o hardware gráfico do driver de miniport não está em conformidade com as regras copp. DxgkDdiOPMGetCertificateSize também pode retornar esse valor se o driver de miniporto detectou adulteração.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	O driver de miniporto de exibição não dá suporte à UAB porque o fornecedor de hardware nunca assinou o contrato de licença da UAB ou o hardware de elementos gráficos do driver de miniporto não está em conformidade com as regras da UAB. DxgkDdiOPMGetCertificateSize também poderá retornar esse valor se o driver de miniporto de exibição detectou adulteração.
STATUS_GRAPHICS_PVP_HFS_FAILED	Falha na verificação da funcionalidade de hardware do driver de miniporto de exibição (HFS) ou o driver de miniporto de exibição detectou adulteração. Opcionalmente, um driver de miniporto de exibição pode retornar esse valor. Se DxgkDdiOPMGetCertificateSize não retornar esse valor para adulteração, ele poderá retornar um dos códigos de erro anteriores.

Essa função também pode retornar outros códigos de erro definidos em Ntstatus.h.

Observações

DxgkDdiOPMGetCertificateSize pode recuperar o tamanho do certificado OPM do driver do miniporto de exibição, do certificado UAB (Barramento Acessível pelo Usuário) ou do certificado COPP (Certified Output Protection Protocol). Para obter informações sobre esses certificados, baixe o documento Proteção de Conteúdo de Saída e o Windows Vista documento.

DxgkDdiOPMGetCertificateSize deve ser tornada paginável.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Área de trabalho
cabeçalho	dispmprt.h (inclua Dispmprt.h)
IRQL	PASSIVE_LEVEL (consulte a seção Comentários)

Consulte também

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

Partilhar via