функция обратного вызова PFND3DDDI_RESOLVESHAREDRESOURCE (d3dumddi.h)

Статья
02/06/2025

Функция ResolveSharedResource сообщает драйверу отображения пользовательского режима, что владение общей поверхностью изменилось или что поверхность используется для взаимодействия GDI.

Синтаксис

PFND3DDDI_RESOLVESHAREDRESOURCE Pfnd3dddiResolvesharedresource;

HRESULT Pfnd3dddiResolvesharedresource(
  HANDLE hDevice,
  const D3DDDIARG_RESOLVESHAREDRESOURCE *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор отображаемого устройства (то есть контекст графики), связанный с общей поверхностью или областью взаимодействия GDI.

unnamedParam2

pData [in]

Указатель на структуру D3DDDIARG_RESOLVESHAREDRESOURCE, содержащую дескриптор на поверхность.

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

ResolveSharedResource возвращает одно из следующих значений:

Возвращаемый код	Описание
S_OK	Ресурс успешно разрешен.
D3DDDIERR_DEVICEREMOVED	Драйвер обнаруживает, что графический адаптер был удален. Поэтому драйвер не выполнил операцию. Если драйвер никогда не замечает условие удаления адаптера, драйвер не требуется возвращать этот код ошибки.

Замечания

Среда выполнения Direct3D вызывает ResolveSharedResource, когда приложение вызывает одну из следующих функций:

IDXGIKeyedMutex::ReleaseSynch на синхронизированной общей поверхности
IDXGISurface1::GetDC для поверхности взаимодействия GDI

Среда выполнения вызывает функцию ResolveSharedResource драйвера при каждом изменении владельца общей поверхности или при использовании поверхности для взаимодействия GDI. Среда выполнения предоставляет ResolveSharedResource с дескрипторами для отображения устройства через параметр hDevice и surface-через параметр pData.

Драйвер реализует ResolveSharedResource для соответствующего управления ресурсами для нескольких сценариев GPU. Каждый ресурс может быть разделен на память для нескольких GPU для отрисовки. Драйвер может реализовать ResolveSharedResource для повторного объединения каждого ресурса, чтобы новый владелец ресурса получил объединенный ресурс. Драйвер должен очистить все частично созданные буферы команд, которые могут изменить ресурс.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	ResolveSharedResource поддерживается начиная с операционной системы Windows 7.
целевая платформа	Настольный
заголовка	d3dumddi.h (include D3dumddi.h)

См. также

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Поделиться через