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 miniport 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 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 miniport.

[out] CertificateBuffer

Um ponteiro para um buffer que recebe o certificado solicitado se DxgkDdiOPMGetCertificate retornar com êxito . Se DxgkDdiOPMGetCertificate falhar, o conteúdo do buffer permanecerá inalterado.

Retornar valor

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 poderá retornar esse valor se o driver de miniporto de exibição detectar adulteração.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	O driver de miniporto de exibição também 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 poderá retornar esse valor se o driver de miniporto de exibição detectar adulteração.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	O driver de miniporto de exibição também 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 miniport não está em conformidade com as regras da UAB. DxgkDdiOPMGetCertificate 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 miniporto de exibição (HFS) ou o driver de miniporto de exibição detectou adulteração. Opcionalmente, um driver de miniporte 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.

Comentários

O DxgkDdiOPMGetCertificate pode recuperar o certificado OPM do driver de miniporto 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 Windows Vista .

DxgkDdiOPMGetCertificate deve ser tornado paginável.

Requisitos

Requisito	Valor
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

DxgkDdiOPMGetCertificateSize