функция обратного вызова DXGKDDI_OPM_GET_CERTIFICATE (dispmprt.h)

  • Статья

Функция DxgkDdiOPMGetCertificate извлекает сертификат заданного типа и размера.

Синтаксис

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

NTSTATUS DxgkddiOpmGetCertificate(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [in]  ULONG CertificateSize,
  [out] PVOID CertificateBuffer
)
{...}

Параметры

[in] MiniportDeviceContext

Дескриптор для блока контекста, связанного с видеоадаптером. Ранее функция DxgkDdiAddDevice драйвера мини-порта дисплея предоставляла этот дескриптор подсистеме ядра графики DirectX.

[in] CertificateType

Значение типа DXGKMDT_CERTIFICATE_TYPE, определяющее тип извлекаемого сертификата.

[in] CertificateSize

Размер извлекаемого сертификата в байтах. Этот размер был возвращен вызовом функции DxgkDdiOPMGetCertificateSize драйвера мини-порта дисплея.

[out] CertificateBuffer

Указатель на буфер, который получает запрошенный сертификат, если dxgkDdiOPMGetCertificate возвращает успешно. Если DxgkDdiOPMGetCertificate завершается сбоем, содержимое буфера не изменяется.

Возвращаемое значение

DxgkDdiOPMGetCertificate возвращает одно из следующих значений.

Код возврата Описание
STATUS_SUCCESS Функция успешно извлекла размер сертификата.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED Драйвер мини-порта дисплея не поддерживает OPM, так как поставщик оборудования никогда не подписывал лицензионное соглашение OPM или графическое оборудование драйвера мини-порта не соответствует правилам OPM. DxgkDdiOPMGetCertificate также может возвращать это значение, если драйвер мини-порта дисплея обнаружил незаконное изменение.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED Драйвер минипорта дисплея не поддерживает COPP, так как поставщик оборудования никогда не подписывал лицензионное соглашение COPP или графическое оборудование драйвера мини-порта не соответствует правилам COPP. DxgkDdiOPMGetCertificate также может возвращать это значение, если драйвер мини-порта дисплея обнаружил незаконное изменение.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED Драйвер минипорта дисплея не поддерживает UAB, так как поставщик оборудования никогда не подписывал лицензионное соглашение UAB или графическое оборудование драйвера мини-порта не соответствует правилам UAB. DxgkDdiOPMGetCertificate также может возвращать это значение, если драйвер мини-порта дисплея обнаружил незаконное изменение.
STATUS_GRAPHICS_PVP_HFS_FAILED Не удалось проверить аппаратные функциональные возможности драйвера дисплея (HFS) или драйвер минипорта дисплея обнаружил незаконное изменение. При необходимости драйвер мини-порта дисплея может возвращать это значение. Если DxgkDdiOPMGetCertificate не возвращает это значение для изменения, он может вернуть один из предыдущих кодов ошибок.

Эта функция также может возвращать другие коды ошибок, определенные в Ntstatus.h.

Комментарии

DxgkDdiOPMGetCertificate может получить сертификат OPM драйвера минипорта дисплея, сертификат шины с доступом для пользователей (UAB) или сертификат протокола COPP. Для получения сведений об этих сертификатах скачайте документ Защита содержимого выходных данных и Windows Vista .

DxgkDdiOPMGetCertificate следует сделать страничным.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dispmprt.h (включая Dispmprt.h)
IRQL PASSIVE_LEVEL (см. раздел "Примечания")

См. также раздел

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

DxgkDdiOPMGetCertificateSize