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

  • Artigo

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

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 miniporta de exibição forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] CertificateType

Um valor do tipo DXGKMDT_CERTIFICATE_TYPE 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 .

Retornar valor

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 miniporta de vídeo 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 miniporto 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 detectar adulteração.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED O driver de miniporta 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 miniporto não está em conformidade com as regras copp. DxgkDdiOPMGetCertificateSize também poderá retornar esse valor se o driver de miniporto detectou adulteração.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED O driver de miniporta 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 gráfico 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 detectar adulteração.
STATUS_GRAPHICS_PVP_HFS_FAILED Falha na verificação de funcionalidade de hardware do driver de miniporta de exibição (HFS) ou o driver de miniporta de exibição detectou adulteração. Opcionalmente, um driver de miniporta 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.

Comentários

DxgkDdiOPMGetCertificateSize pode recuperar o tamanho do certificado OPM do driver de miniporta 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 Windows Vista .

DxgkDdiOPMGetCertificateSize deve ser tornado paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h (inclua Dispmprt.h)
IRQL PASSIVE_LEVEL (consulte a seção Comentários)

Confira também

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice