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

Статья
02/06/2025

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

Синтаксис

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in]

Указатель на структуру D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2, описывающую объекты синхронизации и поток DMA контекста, на который настроен сигнал.

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

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

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

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

Замечания

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

Функция pfnSignalSynchronizationObject2Cb отправляет сигнальную команду в поток команд всех контекстов Microsoft Direct3D, указанных hContext и BroadcastContext членов структуры D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. Объекты синхронизации сигнализируются только при обработке всех отправленных команд сигнала.

Если объекты синхронизации имеют тип D3DDDI_FENCE (где D3DDDI_SYNCHRONIZATIONOBJECTINFO2.тип = D3DDDI_FENCE), они должны быть отправлены одновременно и D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2.ObjectCount должно иметь значение 1.

Требования

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

См. также

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2

pfnCreateSynchronizationObject2Cb

pfnDesynchronizationObjectCb

pfnWaitForSynchronizationObject2Cb

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