Поделиться через


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

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

Синтаксис

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

Параметры

[in] MiniportDeviceContext

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

[in] CertificateType

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

[out] CertificateSize

Указатель на переменную, которая получает размер (в байтах) сертификата, тип которого определяется значением в параметре CertificateType .

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

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

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

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

Комментарии

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

DxgkDdiOPMGetCertificateSize должен быть доступным для страниц.

Требования

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

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

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice