PFND3D10DDI_RETRIEVESUBOBJECT回调函数 (d3d10umddi.h)

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

标识正在检索的函数表的子设备 ID。 请参阅“备注”。

ParamSize

pParams 指向的输入参数结构的大小（以字节为单位）。

pParams

指向 SubDeviceID 参数描述的输入参数结构的指针。 请参阅“备注”。

OutputParamSize

pOutputParamsBuffer 指向的输出参数结构的大小（以字节为单位）。

pOutputParamsBuffer

指向 SubDeviceID 参数描述的输出参数结构的指针。 请参阅“备注”。

返回值

如果操作成功，则返回S_OK。 否则，此函数将返回相应的错误结果。

注解

下表描述了 SubDeviceID 的可能值、pParams 指向的关联输入结构，以及 pOutputParamsBuffer 指向的缓冲区中PFND3D10DDI_RETRIEVESUBOBJECT返回的输出结构。

SubDeviceID	含义	pParams	pOutputParamsBuffer
2	D3D 11 视频函数表的子 ID。	D3D11_1DDI_VIDEO_INPUT	D3D11_1DDI_VIDEODEVICEFUNCS
3	WDDM 2.0 视频函数表的子 ID。	D3DWDDM2_0DDI_VIDEO_INPUT	D3DWDDM2_0DDI_VIDEODEVICEFUNCS
5	WDDM 2.1 视频函数表的子 ID。	D3DWDDM2_1DDI_VIDEO_INPUT	D3DWDDM2_1DDI_VIDEODEVICEFUNCS 。
6	WDDM 2.4 及更高版本的视频函数表的子 ID。 从 WDDM 2.4 开始受支持。	D3DWDDM2_4DDI_VIDEO_INPUT	D3DWDDM2_4DDI_VIDEODEVICEFUNCS。
7	WDDM 2.4 (Windows 10 版本 1803 的子 ID) 视频函数表。	D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0	D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0

Direct3D 运行时将检索到的子部分视为追加到 Direct3D 驱动程序设备对象，并期望在调用 DestroyDevice 时将它们与设备的其余部分一起销毁。

从根设备对象独立检索子设备。 DDI 接口版本在子设备 ID 中隐式提供。

此函数是自由线程函数。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
目标平台	桌面
标头	d3d10umddi.h (包括 D3d10umddi.h)

另请参阅

DestroyDevice