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

  • Статья

Функция 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 (включая D3dumddi.h)

См. также раздел

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS