функция обратного вызова 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) |