DXGKDDI_OPM_GET_CERTIFICATE función de devolución de llamada (dispmprt.h)

Artículo
04/03/2024

La función DxgkDdiOPMGetCertificate recupera un certificado del tipo y tamaño especificados.

Sintaxis

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

Identificador de un bloque de contexto asociado a un adaptador de pantalla. Anteriormente, la función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó este identificador al subsistema del kernel de gráficos de DirectX.

[in] CertificateType

Valor DXGKMDT_CERTIFICATE_TYPE con tipo que identifica el tipo de certificado que se va a recuperar.

[in] CertificateSize

Tamaño, en bytes, del certificado que se va a recuperar. Esta función DxgkDdiOPMGetCertificateSize devolvió este tamaño a la función DxgkDdiOPMGetCertificateSize del controlador de pantalla.

[out] CertificateBuffer

Puntero a un búfer que recibe el certificado solicitado si DxgkDdiOPMGetCertificate devuelve correctamente. Si se produce un error en DxgkDdiOPMGetCertificate , el contenido del búfer no cambia.

Valor devuelto

DxgkDdiOPMGetCertificate devuelve uno de los valores siguientes.

Código devuelto	Descripción
STATUS_SUCCESS	La función recuperó correctamente el tamaño del certificado.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	El controlador de miniporte de pantalla no admite OPM, ya sea porque el proveedor de hardware nunca firmó el contrato de licencia de OPM o el hardware gráfico del controlador de miniporte no cumple con las reglas de OPM. DxgkDdiOPMGetCertificate también puede devolver este valor si el controlador de miniporte de pantalla detectó alteraciones.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	El controlador de minipuerto de pantalla no admite COPP, ya sea porque el proveedor de hardware nunca firmó el contrato de licencia copP o el hardware gráfico del controlador de miniporte no cumple con las reglas copP. DxgkDdiOPMGetCertificate también puede devolver este valor si el controlador de miniporte de pantalla detectó alteraciones.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	El controlador de minipuerto de pantalla no es compatible con EL ODBC, ya sea porque el proveedor de hardware nunca firmó el contrato de licencia DE LA AGRUPACIÓN o el hardware gráfico del controlador de miniporte no cumple con las reglas de LAMC. DxgkDdiOPMGetCertificate también puede devolver este valor si el controlador de miniporte de pantalla detectó alteraciones.
STATUS_GRAPHICS_PVP_HFS_FAILED	Error en el examen de funcionalidad de hardware del controlador de miniporte de pantalla (HFS) o el controlador de miniporte de pantalla detectó alteraciones. Un controlador de minipuerto de pantalla puede devolver opcionalmente este valor. Si DxgkDdiOPMGetCertificate no devuelve este valor para la manipulación, puede devolver uno de los códigos de error anteriores en su lugar.

Esta función también puede devolver otros códigos de error definidos en Ntstatus.h.

Comentarios

DxgkDdiOPMGetCertificate puede recuperar el certificado OPM del controlador de miniporte para mostrar, el certificado del Bus accesible por el usuario (ODBC) o el certificado del Protocolo de protección de salida certificada (COPP). Para obtener información sobre estos certificados, descargue el documento Protección de contenido de salida y Windows Vista .

DxgkDdiOPMGetCertificate debe ser paginable.