функция обратного вызова DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET (d3dkmddi.h)
Функция pfnAcquireMonitorSourceModeSet возвращает дескриптор объекту набора исходного режима монитора, связанному с указанным монитором.
Синтаксис
DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;
NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}
Параметры
[in] hAdapter
Дескриптор, определяющий адаптер отображения. Подсистема ядра графики Microsoft DirectX ранее предоставила этот дескриптор для драйвера мини-порта отображения в параметре DxgkInterface функции dxgkDdiStartDevice.
[in] VideoPresentTargetId
Целое число, определяющее один из целевых объектов видео, присутствующих на адаптере дисплея. Возвращаемый объект набора исходного режима описывает режимы, доступные на мониторе, подключенном к этому целевому объекту видео.
[out] phMonitorSourceModeSet
Указатель на переменную, получающую дескриптор в объект набора исходного режима монитора.
[out] ppMonitorSourceModeSetInterface
Указатель на переменную, которая получает указатель на структуру DXGK_MONITORSOURCEMODESET_INTERFACE. Структура содержит указатели на функции, которые драйвер мини-порта отображения может вызывать для проверки и изменения объекта набора исходного режима монитора.
Возвращаемое значение
Функция pfnAcquireMonitorSourceModeSet возвращает одно из следующих значений.
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Функция завершилась успешно. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Дескриптор, предоставленный в hAdapter, был недопустим. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | Идентификатор, предоставленный в VideoPresentTargetId, был недопустимым. |
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Монитор не подключен к целевому объекту видео, определенному VideoPresentTargetId. |
Эта функция также может возвращать другие коды ошибок, определенные в Ntstatus.h.
Замечания
Целевые идентификаторы VidPN назначаются драйвером мини-порта отображения. Функция dxgkDdiQueryChildRelations, реализованная драйвером мини-порта отображения, возвращает массив структур DXGK_CHILD_DESCRIPTOR, каждый из которых содержит идентификатор.
После завершения работы с дескриптором набора объектов в режиме мониторинга необходимо освободить дескриптор, вызвав pfnReleaseMonitorSourceModeSet. Объекты набора целевых режимов считаются ссылочными, поэтому если вы получаете дескриптор несколько раз, необходимо освободить его одинаковое количество раз.
Эта функция также доступна в интерфейсе DXGK_MONITOR_INTERFACE_V2, начиная с Windows 7.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |