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