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