Export (0) Print
Expand All

IDXGIObject::GetPrivateData method

Get a pointer to the object's data.

Syntax


HRESULT GetPrivateData(
  [in]       REFGUID Name,
  [in, out]  UINT *pDataSize,
  [out]      void *pData
);

Parameters

Name [in]

Type: REFGUID

A GUID identifying the data.

pDataSize [in, out]

Type: UINT*

The size of the data.

pData [out]

Type: void*

Pointer to the data.

Return value

Type: HRESULT

Returns one of the following DXGI_ERROR.

Remarks

If the data returned is a pointer to an IUnknown, or one of its derivative classes, previously set by IDXGIObject::SetPrivateDataInterface, you must call ::Release() on the pointer before the pointer is freed to decrement the reference count.

You can pass GUID_DeviceType in the Name parameter of GetPrivateData to retrieve the device type from the display adapter object (IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2).

Bb174543.wedge(en-us,VS.85).gifTo get the type of device on which the display adapter was created

  1. Call IUnknown::QueryInterface on the ID3D11Device or ID3D10Device object to retrieve the IDXGIDevice object.
  2. Call GetParent on the IDXGIDevice object to retrieve the IDXGIAdapter object.
  3. Call GetPrivateData on the IDXGIAdapter object with GUID_DeviceType to retrieve the type of device on which the display adapter was created. pData will point to a value from the driver-type enumeration (for example, a value from D3D_DRIVER_TYPE).

On Windows 7 or earlier, this type is either a value from D3D10_DRIVER_TYPE or D3D_DRIVER_TYPE depending on which kind of device was created. On Windows 8, this type is always a value from D3D_DRIVER_TYPE. Don't use IDXGIObject::SetPrivateData with GUID_DeviceType because the behavior when doing so is undefined.

Windows Phone 8: This API is supported.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIObject
DXGI Interfaces

 

 

Community Additions

ADD
Show:
© 2014 Microsoft