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

Статья
02/06/2025

Функция 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. Для получения сведений об этих сертификатах скачайте документ Output Content Protection и Windows Vista.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Настольный
заголовка	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL (см. раздел "Примечания")

См. также

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

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