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

Статья
08/07/2023

Вставляет сигнал в указанные объекты синхронизации в указанном контекстном потоке прямого доступа к памяти (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 (включая D3dumddi.h)