функция обратного вызова DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO (d3dkmddi.h)
Функция pfnAcquireNextDescriptorInfo возвращает следующий дескриптор в наборе дескрипторов монитора, учитывая текущий дескриптор.
Синтаксис
DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo;
NTSTATUS DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo(
[in] IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
[in] IN_CONST_PD3DKMDT_MONITOR_DESCRIPTOR_CONST pMonitorDescriptorInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppNextMonitorDescriptorInfo
)
{...}
Параметры
[in] hMonitorDescriptorSet
Дескриптор набора дескрипторов монитора. Драйвер минипорта отображения ранее получил этот дескриптор, вызвав функцию pfnGetMonitorDescriptorSet интерфейса монитора .
[in] pMonitorDescriptorInfo
Указатель на структуру D3DKMDT_MONITOR_DESCRIPTOR, которая является текущим дескриптором. Драйвер минипорта отображения ранее получил этот указатель путем вызова pfnAcquireFirstDescriptorInfo или pfnAcquireNextDescriptorInfo.
[out] ppNextMonitorDescriptorInfo
Указатель на переменную, которая получает указатель на структуру D3DKMDT_MONITOR_DESCRIPTOR. Структура представляет собой следующий дескриптор в наборе.
Возвращаемое значение
Функция pfnAcquireNextDescriptorInfo возвращает одно из следующих значений.
Возвращаемый код | Описание |
---|---|
STATUS_SUCCESS | Функция успешно вернула следующий дескриптор в наборе. |
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET | Функция завершилась успешно, но в наборе не было больше дескрипторов. |
STATUS_INVALID_PARAMETER | Указан недопустимый параметр. |
STATUS_INVALID_MONITOR_DESCRIPTOR | Дескриптор, предоставленный в pMonitorDescriptorInfo, был недопустим. |
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET | Дескриптор, предоставленный в hMonitorDescriptorSet, был недопустим. |
Замечания
Завершив использование структуры D3DKMDT_MONITOR_DESCRIPTOR, необходимо освободить структуру, вызвав pfnReleaseDescriptorInfo.
Вы можете получить все дескрипторы в дескрипторе монитора, вызвав pfnAcquireFirstDescriptorInfo, а затем выполнив последовательность вызовов pfnAcquireNextDescriptorInfo.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows Vista |
целевая платформа | Настольный |
заголовка | d3dkmddi.h (include D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |