функция обратного вызова DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO (d3dkmddi.h)

Статья
02/06/2025

pfnAcquirePreferredModeInfo возвращает дескриптор предпочтительного режима в указанном объекте набора исходного режима монитора.

Синтаксис

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

Параметры

[in] hMonitorSourceModeSet

Дескриптор объекта набора исходного режима монитора. Драйвер мини-порта дисплея ранее получил этот дескриптор путем вызова функции pfnAcquireMonitorSourceModeSet интерфейса монитора .

[out] ppFirstMonitorSourceModeInfo

Указатель на переменную, которая получает указатель на структуру D3DKMDT_MONITOR_SOURCE_MODE. Структура содержит различные сведения о предпочтительном режиме источника монитора, включая его идентификатор и видео сигнал.

Возвращаемое значение

Функция pfnAcquirePreferredModeInfo возвращает одно из следующих значений.

Возвращаемый код	Описание
STATUS_SUCCESS	Функция успешно вернула дескриптор предпочтительного режима.
STATIS_GRAPHICS_NO_PREFERRED_MODE	Функция завершилась успешно, но указанный набор режимов источника монитора не имеет предпочтительного режима.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	Дескриптор, предоставленный в hMonitorSourceModeSet, был недопустим.

Замечания

Завершив использование структуры D3DKMDT_MONITOR_SOURCE_MODE, необходимо освободить структуру, вызвав pfnReleaseModeInfo.

Тип данных D3DKMDT_HMONITORSOURCEMODESET определен в D3dkmdt.h.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Поделиться через