функция обратного вызова DXGKDDI_RECOMMENDVIDPNTOPOLOGY (d3dkmddi.h)
Функция dxgkDdiRecommendVidPnTopology создает топологию указанного VidPN или расширяет топологию с новым путем к целевым объектам видео.
Синтаксис
DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;
NTSTATUS DxgkddiRecommendvidpntopology(
IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}
Параметры
hAdapter
Дескриптор к блоку контекста, связанному с адаптером отображения. Драйвер минипорта отображения ранее предоставил этот дескриптор подсистеме ядра графики Microsoft DirectX в MiniportDeviceContext выходном параметре функции DxgkDdiAddDevice.
[in] pRecommendVidPnTopology
Указатель на DXGKARG_RECOMMENDVIDPNTOPOLOGY структуру, содержащую аргументы функции.
Возвращаемое значение
DxgkDdiRecommendVidPnTopology возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Функция успешно создана или дополнена топологией. |
| STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY | Функция не содержит рекомендаций по увеличению указанной топологии VidPN. |
| STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION | Функция рекомендует отменить расширение указанной топологии VidPN в указанном источнике. Этот код возврата допускается только в случае расширения топологии VidPN. |
| STATUS_NO_MEMORY | Не удалось выполнить функцию, так как она не смогла выделить достаточно памяти. |
Минипорт-драйвер должен пройти любой код ошибки, полученный из операционной системы, для которой он не имеет резервный путь кода.
Замечания
DxgkDdiRecommendVidPnTopology должны быть доступны для страниц.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |