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

Статья
02/06/2025

Вставляет команду ожидания для указанных объектов синхронизации в указанном потоке команд контекста. Используется драйверами windows Display Driver Model (WDDM) 1.2 и более поздних версий пользовательского режима.

Синтаксис

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

HRESULT Pfnd3dddiWaitforsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор отображаемого устройства (то есть контекст графики).

unnamedParam2

pData [in]

Указатель на структуру D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2, описывающую объекты синхронизации и поток DMA контекста, необходимые для настройки ожидания.

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

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

код возврата	описание
S_OK	Ожидание успешно настроено.
E_INVALIDARG	Параметры были проверены и определены как неверные.

Эта функция также может возвращать другие значения HRESULT.

Замечания

Функция pfnCreateSynchronizationObject2Cb возвращает дескриптор режима ядра только что созданному объекту синхронизации в hSyncObject член структуры D3DDDICB_CREATESYNCHRONIZATIONOBJECT2, на которую указывает параметр pData. Драйвер отображения в пользовательском режиме передает этот дескриптор в вызовах следующих функций:

Не вызывайте эту функцию, если объект синхронизации имеет тип D3DDDI_CPU_NOTIFICATION— а именно, тип член структуры D3DDDI_SYNCHRONIZATIONOBJECTINFO2 имеет значение D3DDDI_CPU_NOTIFICATION.pfnDesynchronizationObjectCb

Требования

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