PFND3D10DDI_RETRIEVESUBOBJECT callback function (d3d10umddi.h)

The Direct3D runtime calls the driver's PFND3D10DDI_RETRIEVESUBOBJECT function to retrieve subparts of the Direct3D driver device object.

Syntax

PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;

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

Parameters

unnamedParam1

hDevice [in] A handle to the display device (graphics context).

SubDeviceID

Sub-device ID that identifies the function table being retrieved. See Remarks.

ParamSize

The size, in bytes, of the input parameter structure that pParams points to.

pParams

A pointer to an input parameter structure that is described by the SubDeviceID parameter. See Remarks.

OutputParamSize

The size, in bytes, of the output parameter structure that pOutputParamsBuffer points to.

pOutputParamsBuffer

A pointer to an output parameter structure that is described by the SubDeviceID parameter. See Remarks.

Return value

Returns S_OK if the operation succeeds. Otherwise, this function returns an appropriate error result.

Remarks

The following table describes the possible values for SubDeviceID, the associated input structure pointed to by pParams, and the output structure that PFND3D10DDI_RETRIEVESUBOBJECT returns in the buffer pointed to by pOutputParamsBuffer .

SubDeviceID Meaning pParams pOutputParamsBuffer
2 Sub ID for a D3D 11 video function table. D3D11_1DDI_VIDEO_INPUT D3D11_1DDI_VIDEODEVICEFUNCS
3 Sub ID for a WDDM 2.0 video function table. D3DWDDM2_0DDI_VIDEO_INPUT D3DWDDM2_0DDI_VIDEODEVICEFUNCS
5 Sub ID for a WDDM 2.1 video function table. D3DWDDM2_1DDI_VIDEO_INPUT D3DWDDM2_1DDI_VIDEODEVICEFUNCS .
6 Sub ID for a WDDM 2.4 and later video function table. Supported starting with WDDM 2.4. D3DWDDM2_4DDI_VIDEO_INPUT D3DWDDM2_4DDI_VIDEODEVICEFUNCS.
7 Sub ID for a WDDM 2.4 (Windows 10 version 1803 release) video function table. D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0

The Direct3D runtime considers the retrieved subparts to be appended to the Direct3D driver device object and expects them to be destroyed along with the rest of the device when DestroyDevice is called.

Subdevices are retrieved from the root device object independently. The DDI interface version is provided implicitly within the sub-device ID.

This function is free-threaded.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See also

DestroyDevice