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_RETRIEVESUBOBJECTPFND3D10DDI_RETRIEVESUBOBJECTpOutputParamsBuffer 所指向之緩衝區中傳回的輸出結構。
| 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） |