функция обратного вызова DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO (d3dkmddi.h)
Функция pfnAcquireNextModeInfo возвращает дескриптор следующего режима в заданном наборе исходного режима монитора, учитывая текущий режим.
Синтаксис
DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
[in] IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}
Параметры
[in] hMonitorSourceModeSet
Дескриптор объекта набора исходного режима монитора. Драйвер мини-порта дисплея ранее получил этот дескриптор путем вызова функции pfnAcquireMonitorSourceModeSet интерфейса монитора .
[in] pMonitorSourceModeInfo
Указатель на структуру D3DKMDT_MONITOR_SOURCE_MODE, описывающую текущий режим. Драйвер мини-порта отображения ранее получил этот указатель путем вызова pfnAcquireFirstModeInfo или pfnAcquireNextModeInfo.
[out] ppNextMonitorSourceModeInfo
Указатель на переменную, которая получает указатель на структуру D3DKMDT_MONITOR_SOURCE_MODE, описывающую следующий режим.
Возвращаемое значение
Функция pfnAcquireNextModeInfo возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Функция завершилась успешно. |
| STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET | Дескриптор, предоставленный в hMonitorSourceModeSet, был недопустимым. |
Замечания
Завершив использование структуры D3DKMDT_MONITOR_SOURCE_MODE, необходимо освободить структуру, вызвав pfnReleaseModeInfo.
Можно перечислить все режимы, принадлежащие определенному объекту режима источника монитора, вызвав pfnAcquireFirstModeInfo, а затем выполните последовательность вызовов pfnAcquireNextModeInfo.
Тип данных D3DKMDT_HMONITORSOURCEMODESET определен в D3dkmdt.h.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |