Функция 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) в буфере, на который указывает член D3DKMT_INVALIDATEACTIVEVIDPN pPrivateDriverData, не поддерживается драйвером мини-порта дисплея. Это значение состояния также будет возвращено, если эта функция вызывается на компьютере под управлением 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 из буфера, на который указывает pPrivateDriverData члена D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD может вызывать D3DKMTInvalidateActiveVidPn для режимов отображения (например, режима клонирования), которые не поддерживаются с помощью более общего вызова функции D3DKMTSetDisplayMode.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows для отображения драйверов мини-портов с < DXGKDDI_INTERFACE_VERSION_WIN7 версии. |
| целевая платформа | Всеобщий |
| заголовка | d3dkmthk.h (include D3dkmthk.h) |
| библиотеки | Gdi32.lib |
| DLL | Gdi32.dll |