функция обратного вызова DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO (d3dkmddi.h)
Структура pfnAcquireFirstPathInfo возвращает дескриптор первого пути в указанном объекте топологии VidPN.
Синтаксис
DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}
Параметры
[in] hVidPnTopology
Дескриптор объекта топологии VidPN. Драйвер мини-порта отображения ранее получил этот дескриптор, вызвав функцию pfnGetTopology интерфейса DXGK_VIDPN_INTERFACE.
[out] ppFirstVidPnPresentPathInfo
Указатель на переменную, которая получает указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH. Структура содержит различные сведения о пути, включая исходные и целевые идентификаторы пути.
Возвращаемое значение
Функция pfnAcquireFirstPathInfo возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| 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 |