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

Статья
02/06/2025

Среда выполнения Direct3D вызывает функцию PFND3D10DDI_RETRIEVESUBOBJECT драйвера для получения подпартий объекта устройства драйвера Direct3D.

Синтаксис

PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;

HRESULT Pfnd3d10ddiRetrievesubobject(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT32 SubDeviceID,
  SIZE_T ParamSize,
  void *pParams,
  SIZE_T OutputParamSize,
  void *pOutputParamsBuffer
)
{...}

Параметры

unnamedParam1

hDevice [in] Дескриптор для устройства отображения (графический контекст).

SubDeviceID

Идентификатор дочернего устройства, определяющий извлекаемую таблицу функций. См. примечания.

ParamSize

Размер в байтах входной структуры параметров, на которую pParams указывает.

pParams

Указатель на структуру входных параметров, описанную параметром SubDeviceID. См. примечания.

OutputParamSize

Размер в байтах выходной структуры параметров, на которую pOutputParamsBuffer.

pOutputParamsBuffer

Указатель на структуру выходных параметров, описанную параметром SubDeviceID. См. примечания.

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

Возвращает S_OK, если операция выполнена успешно. В противном случае эта функция возвращает соответствующий результат ошибки.

Замечания

В следующей таблице описываются возможные значения SubDeviceID, связанная входная структура, на которую указывает pParams, и выходная структура, которая PFND3D10DDI_RETRIEVESUBOBJECT возвращается в буфере, на который указывает pOutputParamsBuffer.

SubDeviceID	Значение	pParams	pOutputParamsBuffer
2	Идентификатор вложенных данных для таблицы видео-функций D3D 11.	D3D11_1DDI_VIDEO_INPUT	D3D11_1DDI_VIDEODEVICEFUNCS
3	Вложенный идентификатор таблицы видео-функций WDDM 2.0.	D3DWDDM2_0DDI_VIDEO_INPUT	D3DWDDM2_0DDI_VIDEODEVICEFUNCS
5	Вложенный идентификатор таблицы видео-функций WDDM 2.1.	D3DWDDM2_1DDI_VIDEO_INPUT	D3DWDDM2_1DDI_VIDEODEVICEFUNCS .
6	Вложенный идентификатор таблицы функций WDDM 2.4 и более поздних версий. Поддерживается начиная с WDDM 2.4.	D3DWDDM2_4DDI_VIDEO_INPUT	D3DWDDM2_4DDI_VIDEODEVICEFUNCS.
7	Вложенный идентификатор таблицы видео-функций WDDM 2.4 (выпуск Windows 10 версии 1803).	D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0	D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0

Среда выполнения Direct3D рассматривает извлеченные вложенные части, добавляемые к объекту устройства драйвера Direct3D, и ожидает, что они будут уничтожены вместе с остальной частью устройства при вызове DestroyDevice.

Вложенные объекты извлекаются из корневого объекта устройства независимо. Версия интерфейса DDI предоставляется неявно в идентификаторе дочернего устройства.

Эта функция является свободной потоковой.

Требования

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

См. также

DestroyDevice

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