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


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

Среда выполнения 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 (WDDM) 1.3 и более поздние версии, завершает вызов PFND3DDDI_GETCAPS и возвращает S_OK, но не изменяет данные в структуре D3DDDIARG_GETCAPS, он указывает среде выполнения Direct3D, что оборудование и драйвер не поддерживают простую инстантирование. Дополнительные сведения см. в D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.

Требования

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

См. также

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS