функция обратного вызова 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
Указатель на буфер, который получает запрошенный сертификат, если DxgkDdiOPMGetCertific ate успешно возвращается. Если 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). Для получения сведений об этих сертификатах скачайте документ Output Content Protection и Windows Vista.
DxgkDdiOPMGetCertificate должны быть доступны для страниц.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (см. раздел "Примечания") |