функция обратного вызова DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO (d3dkmddi.h)
Функция pfnAcquireNextPathInfo возвращает дескриптор следующего видеосущего пути в указанной топологии VidPN, учитывая текущий путь.
Синтаксис
DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}
Параметры
[in] hVidPnTopology
Дескриптор объекта топологии VidPN. Драйвер мини-порта отображения ранее получил этот дескриптор, вызвав функцию pfnGetTopology интерфейса DXGK_VIDPN_INTERFACE.
[in] pVidPnPresentPathInfo
Указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH, описывающую текущий путь. Драйвер мини-порта отображения ранее получил этот указатель путем вызова pfnAcquireFirstPathInfo или pfnAcquireNextPathInfo.
[out] ppNextVidPnPresentPathInfo
Указатель на переменную, которая получает указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH, описывающую следующий путь.
Возвращаемое значение
Функция pfnAcquireNextPathInfo возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Функция завершилась успешно. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Дескриптор, предоставленный в hVidPnTopology, недопустим. |
Замечания
После завершения работы со структурой D3DKMDT_VIDPN_PRESENT_PATH необходимо освободить структуру, вызвав pfnReleasePathInfo.
Можно перечислить все пути, принадлежащие объекту топологии VidPN, вызвав pfnAcquireFirstPathInfo, а затем выполнив последовательность вызовов pfnAcquireNextPathInfo.
Тип данных D3DKMDT_HVIDPNTOPOLOGY определен в D3dkmdt.h.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |