Функция D3DKMTSetDisplayMode (d3dkmthk.h)
Функция D3DKMTSetDisplayMod e задает выделение, которое используется для сканирования на дисплее.
Синтаксис
NTSTATUS D3DKMTSetDisplayMode(
[in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);
Параметры
[in, out] unnamedParam1
Указатель на структуру D3DKMT_SETDISPLAYMODE, описывающую выделение, используемое для сканирования.
Возвращаемое значение
D3DKMTSetDisplayMode возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Режим отображения был успешно установлен. |
| STATUS_DEVICE_REMOVED | Графический адаптер был остановлен или устройство отображения было сброшено. |
| STATUS_INVALID_PARAMETER | Параметры были проверены и определены как неверные. |
| STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | Перед вызовом D3DKMTSetDisplayModeустройство не приобрело эксклюзивное владение представлением. Поэтому устройство не может задать режим отображения. |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | Устанавливаемый драйвер клиента OpenGL (ICD) должен преобразовать формат поверхности, связанной с выделением, которое hPrimaryAllocation член D3DKMT_SETDISPLAYMODE указывает в атрибут формата, который указывает PrivateDriverFormatAttribute член D3DKMT_SETDISPLAYMODE. Затем ICD должен снова вызвать D3DKMTSetDisplayMod e. ICD может выделить новое выделение, выполнить преобразование бит-блок передачи (bitblt) из старого первичного на новый, а затем уничтожить старый первичный, пока ICD использует новый дескриптор выделения для этого выделения для всех последующих операций. ICD должен повторять этот процесс, пока D3DKMTSetDisplayMode возвращает другое возвращаемое значение. |
Эта функция также может возвращать другие значения NTSTATUS.
Замечания
Прежде чем вызовы OpenGL ICD D3DKMTSetDisplayMode, чтобы задать новый режим отображения, использующий расширенный формат, метод множественной выборки или оба, ICD должен убедиться, что текущий режим отображения GDI имеет то же разрешение, что и новый режим отображения. В противном случае D3DKMTSetDisplayMode возвращает STATUS_INVALID_PARAMETER.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Всеобщий |
| заголовка | d3dkmthk.h (include D3dkmthk.h) |
| библиотеки | Gdi32.lib |
| DLL | Gdi32.dll |