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


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

Требования

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

См. также раздел

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS