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

識別所擷取之函式數據表的子裝置標識碼。 請參閱＜備註＞。

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 (包含 D3d10umddi.h)

另請參閱

DestroyDevice