функция обратного вызова DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO (d3dkmddi.h)
Функция pfnAcquirePathInfo возвращает дескриптор текущего пути видео, указанного источником видео и целевым объектом представления видео в конкретной топологии VidPN.
Синтаксис
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
Параметры
[in] hVidPnTopology
Дескриптор объекта топологии VidPN. Драйвер мини-порта отображения ранее получил этот дескриптор, вызвав функцию pfnGetTopology интерфейса DXGK_VIDPN_INTERFACE.
[in] VidPnSourceId
Целое число, идентифицирующее источник видео.
[in] VidPnTargetId
Целое число, идентифицирующее целевой объект видео.
[out] ppVidPnPresentPathInfo
Указатель на переменную, которая получает указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH, описывающую запрошенный путь.
Возвращаемое значение
Функция pfnAcquirePathInfo возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Функция завершилась успешно. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Дескриптор, предоставленный в hVidPnTopology, недопустим. |
Замечания
После завершения работы со структурой D3DKMDT_VIDPN_PRESENT_PATH необходимо освободить структуру, вызвав pfnReleasePathInfo.
Путь содержит пару (источник, целевой объект), а топология — это коллекция путей. Эта функция возвращает дескриптор для пути в указанной топологии, которая содержит указанную пару (источник, целевой объект).
Можно перечислить все пути, принадлежащие объекту топологии VidPN, вызвав pfnAcquireFirstPathInfo, а затем выполнив последовательность вызовов pfnAcquireNextPathInfo.
Идентификаторы источника VidPN назначаются операционной системой. DxgkDdiStartDevice, реализованной драйвером минипорта дисплея, возвращает количество источников видео, поддерживаемых адаптером отображения. Затем операционная система назначает идентификаторы 0, 1, 2, ... N - 1.
Целевые идентификаторы VidPN назначаются драйвером мини-порта отображения. DxgkDdiQueryChildRelations, реализованный драйвером мини-порта отображения, возвращает массив структур DXGK_CHILD_DESCRIPTOR, каждый из которых содержит идентификатор.
Тип данных D3DKMDT_HVIDPNTOPOLOGY определен в D3dkmdt.h.
Типы данных D3DDDI_VIDEO_PRESENT_SOURCE_ID и D3DDDI_VIDEO_PRESENT_TARGET_ID определены в D3dukmdt.h.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |