Функция 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

См. также раздел

D3DKMTSetDisplayMode

D3DKMT_INVALIDATEACTIVEVIDPN