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

Статья
02/23/2024

Среда выполнения D3D вызывает функцию обратного вызова драйвера PFND3DDDI_GETCAPS для запроса возможностей графического адаптера.

Синтаксис

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

Параметры

hAdapter

Дескриптор, идентифицирующий графический адаптер.

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_GETCAPS , описывающую возможности извлечения.

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

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

Код возврата	Описание
S_OK	Возможности были успешно извлечены.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS не удалось выделить необходимую память для ее завершения.

Данные, возвращаемые в элементе pDataструктуры D3DDDIARG_GETCAPS , зависят от типа запрашиваемых данных (то есть данные зависят от D3DDDIARG_GETCAPS. Введите и иногда в элементе pInfo ).

В следующей таблице приведены два примера настройки вызова PFND3DDDI_GETCAPS в зависимости от значения D3DDDIARG_GETCAPS. Тип.

элемент D3DDDIARG_GETCAPS	Пример 1	Пример 2
Тип	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL (условия не заданы)	[in] NULL (условия не заданы)
Pdata	[out] DDRAW_CAPS (уникальный указатель)	[out] UINT* (уникальный указатель)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
Примечания	Драйвер должен заполнить структуру DDRAW_CAPS возможностями DirectDraw, которые он поддерживает.	Драйвер должен заполнить буфер, на который указывает pData , значением UINT, которое представляет количество D3DDDIFORMAT форматов поверхностей, поддерживаемых устройством.

Сведения о других значениях для D3DDDIARG_GETCAPS см. в D3DDDIARG_GETCAPS. Тип, используемый для многоплановых наложений.

Simple_instancing

Если драйвер Direct3D уровня 9, который поддерживает модель windows Display Driver Model (WDDM) 1.3 и более поздних версий, завершает вызов PFND3DDDI_GETCAPS и возвращает S_OK, но не изменяет данные в структуре D3DDDIARG_GETCAPS , это указывает среде выполнения Direct3D, что оборудование и драйвер не поддерживают простой инстансинг. Дополнительные сведения см. в разделе D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.

Требования

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