DXGKDDI_OPM_GET_CERTIFICATE função de retorno de chamada (dispmprt.h)
A função DxgkDdiOPMGetCertificate recupera um certificado do tipo e do tamanho fornecidos.
Sintaxe
DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;
NTSTATUS DxgkddiOpmGetCertificate(
[in] PVOID MiniportDeviceContext,
[in] DXGKMDT_CERTIFICATE_TYPE CertificateType,
[in] ULONG CertificateSize,
[out] PVOID CertificateBuffer
)
{...}
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 a ser recuperado.
[in] CertificateSize
O tamanho, em bytes, do certificado a ser recuperado. Esse tamanho foi retornado por uma chamada para a função DxgkDdiOPMGetCertificateSize do driver de exibição.
[out] CertificateBuffer
Um ponteiro para um buffer que recebe o certificado solicitado se DxgkDdiOPMGetCertificate retorna com êxito. Se DxgkDdiOPMGetCertificate falhar, o conteúdo do buffer ficará inalterado.
Valor de retorno
DxgkDdiOPMGetCertificate retorna um dos valores a seguir.
| 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. DxgkDdiOPMGetCertificate também pode 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. DxgkDdiOPMGetCertificate também pode retornar esse valor se o driver de miniporto de exibição 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. DxgkDdiOPMGetCertificate também pode 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 DxgkDdiOPMGetCertificate 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
DxgkDdiOPMGetCertificate pode recuperar o certificado OPM do driver de miniport de exibição, o certificado UAB (Barramento Acessível pelo Usuário) ou o 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.
DxgkDdiOPMGetCertificate deve ser tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |