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

Статья
02/26/2024

Вставляет команду ожидания для указанных объектов синхронизации в указанном потоке команд контекста. Используется в драйверах 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, а именно, элемент Typeструктуры D3DDDI_SYNCHRONIZATIONOBJECTINFO2 имеет значение D3DDDI_CPU_NOTIFICATION. pfnDesynchronizationObjectCb

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dumddi.h (включая D3dumddi.h)