функция обратного вызова DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO (d3dkmddi.h)
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интерфейса Monitor.
[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 (включая D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |