Метод IDisplayPathInterop::CreateSourcePresentationHandle (windows.devices.display.core.interop.h)

Создает дескриптор NT для управления доступом к сканированию по этому пути. Приложение компонатора может выбрать брокер доступа к путям, которыми оно управляет с помощью этих объектов. Приложение может вызвать IDisplayDeviceInterop.OpenSharedHandle , чтобы создать объект DisplaySource из этого дескриптора.

Синтаксис

HRESULT CreateSourcePresentationHandle(
  HANDLE *pValue
);

Параметры

pValue

Тип: HANDLE*

Указатель на HANDLE , который получает только что созданный исходный объект презентации.

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

Тип: HRESULT

Этот метод возвращает S_OK , если он выполнен успешно, в противном случае — код сбоя, указывающий причину сбоя. В случае успешного выполнения pValue всегда будет указывать на только что созданный дескриптор.

Комментарии

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

• Процесс может указать дескриптор объекта в вызове функции DuplicateHandle , чтобы создать повторяющийся дескриптор, который может использоваться другим процессом.
• Процесс может указать имя объекта в вызове функции IDisplayDeviceInterop.OpenSharedHandle .

Используйте функцию CloseHandle , чтобы закрыть дескриптор. Система автоматически закрывает дескриптор при завершении процесса. Объект уничтожается при закрытии последнего дескриптора и освобождении последней ссылки на интерфейс.

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Целевая платформа	Windows
Header	windows.devices.display.core.interop.h
Библиотека	d3d12.lib
DLL	d3d12.dll