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

Статья
02/23/2024

Функция pfnGetMultisampleMethodListCb извлекает список методов с несколькими выборками, которые используются для заданной ширины, высоты и формата выделения.

Синтаксис

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

Параметры

hAdapter

Дескриптор объекта графического адаптера.

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDICB_GETMULTISAMPLEMETHODLIST , описывающую список методов с несколькими выборками для выделения.

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

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

Код возврата	Описание
S_OK	Список методов с несколькими примерами был успешно получен.
E_INVALIDARG	Параметры были проверены и определены как неверные.

Эта функция также может возвращать другие значения HRESULT.

Драйвер отображения пользовательского режима обычно использует функцию pfnGetMultisampleMethodListCb с функцией CreateResource, CreateResource(D3D10) или CreateResource(D3D11) и функцией pfnAllocateCb . Драйвер использует pfnGetMultisampleMethodListCb , когда среда выполнения Direct3D вызывает createResource, CreateResource(D3D10) или CreateResource(D3D11) драйвера, чтобы запросить создание драйвера первичного источника с несколькими выборками. Драйвер также использует pfnGetMultisampleMethodListCb , когда ему необходимо выполнить многократную выборку при сканировании из основного объекта. Этот тип множественной выборки может потреблять дополнительную пропускную способность памяти, помимо пропускной способности, необходимой для сканирования в режиме отображения. Таким образом, pfnGetMultisampleMethodListCb запрашивает диспетчер режима отображения (DMM) (и косвенно драйвер мини-порта дисплея), чтобы получить список поддерживаемых методов множественной выборки для заданной ширины, высоты и формата. Если pfnGetMultisampleMethodListCb сообщает, что методы не поддерживаются, драйвер отображения пользовательского режима должен использовать несканированную версию множественной выборки, обычно путем создания стандартного первичного элемента, не являющегося многоцелевой выборкой.

Требования

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