Функция D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
Функция D3DKMTInvalidateActiveVidPn делает недействительной активную сеть видеотрансляций (VidPN), используемую в настоящее время.
Примечание
Эта функция устарела в Windows 7 и более поздних версиях операционных систем Windows.
Синтаксис
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Параметры
[in] unnamedParam1
Указатель на структуру D3DKMT_INVALIDATEACTIVEVIDPN , описывающую параметры, которые делают недействительным активный VidPN, используемый в настоящее время.
Возвращаемое значение
D3DKMTInvalidateActiveVidPn возвращает одно из следующих значений:
| Код возврата | Описание |
|---|---|
| STATUS_SUCCESS | Используемый в настоящее время VidPN был успешно признан недействительным. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Графический адаптер не указан в элементе hAdapter D3DKMT_INVALIDATEACTIVEVIDPN , для который необходимо сделать недействительным VidPN. |
| STATUS_NO_MEMORY | Не удалось завершить D3DKMTInvalidateActiveVidPn из-за нехватки памяти. |
| STATUS_NOT_SUPPORTED | Режим отображения, запрашиваемый драйвером клиента OpenGL (ICD) в буфере, на который указывает элемент pPrivateDriverData D3DKMT_INVALIDATEACTIVEVIDPN , не поддерживается драйвером мини-порта дисплея. Это значение состояния также возвращается, если эта функция вызывается на компьютере под управлением Windows 7 и более поздних версий драйвером мини-порта дисплея с DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
| STATUS_DEVICE_REMOVED | Графический адаптер остановлен. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | Драйвер мини-порта дисплея не рекомендовал использовать VidPN для замены используемого в настоящее время VidPN. |
Эта функция также может возвращать другие значения NTSTATUS .
Комментарии
Когда вызывается функция D3DKMTInvalidateActiveVidPn , чтобы сделать недействительным используемый в настоящее время VidPN, текущий VidPN заменяется новым VidPN, рекомендуемым драйвером мини-порта дисплея. Так как драйвер мини-порта дисплея должен рекомендовать новый VidPN, драйвер минипорта дисплея должен иметь возможность определить режим отображения, необходимый для OpenGL ICD, из буфера, на который указывает элемент pPrivateDriverDataD3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD может вызывать D3DKMTInvalidateActiveVidPn для режимов отображения (например, режима клонирования представления), которые не поддерживаются с помощью более общего вызова функции D3DKMTSetDisplayMode .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционных систем Windows для драйверов мини-порта дисплея с версией < DXGKDDI_INTERFACE_VERSION_WIN7. |
| Целевая платформа | Универсальное |
| Верхняя часть | d3dkmthk.h (включая D3dkmthk.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |