RetrieveSubObject(D3D11_1)
TOC
Collapse the table of content
Expand the table of content

RetrieveSubObject(D3D11_1) routine

Retrieves subparts of the Microsoft Direct3D driver device object.

Syntax


PFND3D10DDI_RETRIEVESUBOBJECT RetrieveSubObject(D3D11_1);

HRESULT APIENTRY* RetrieveSubObject(D3D11_1)(
        D3D10DDI_HDEVICE hDevice,
  _In_  UINT32           SubDeviceID,
  _In_  SIZE_T           ParamSize,
  _In_  void             *pParams,
  _In_  SIZE_T           OutputParamSize,
  _Out_ void             *pOutputParamsBuffer
)
{ ... }

Parameters

hDevice

A handle to the display device (graphics context).

SubDeviceID [in]

The function table being retrieved, with the following possible values.

ValueMeaning
1

A video function table that is described as a structure. The function returns a D3D11_1DDI_VIDEODEVICEFUNCS structure in the buffer referenced by the pOutputParamsBuffer parameter.

3

A WDDM 2.0 and later video function table that is described as a structure. The function returns a D3DWDDM2_0DDI_VIDEODEVICEFUNCS structure in the buffer referenced by the pOutputParamsBuffer parameter.

Supported starting with WDDM 2.0.

 

ParamSize [in]

The size, in bytes, of an input parameter structure that is described by the SubDeviceID parameter.

pParams [in]

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

OutputParamSize [in]

The size, in bytes, of an output parameter structure that is described by the SubDeviceID parameter.

pOutputParamsBuffer [out]

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

Return value

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

Remarks

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 subdevice ID.

This function is free-threaded.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform

Desktop

Header

D3d10umddi.h (include D3d10umddi.h)

See also

D3D11_1DDI_VIDEODEVICEFUNCS
D3DWDDM2_0DDI_VIDEODEVICEFUNCS
DestroyDevice

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft