Edit

ID3D12DeviceChild::GetDevice method (d3d12.h)

  • Article

Gets a pointer to the device that created this interface.

Syntax

HRESULT GetDevice(
                  REFIID riid,
  [out, optional] void   **ppvDevice
);

Parameters

riid

Type: REFIID

The globally unique identifier (GUID) for the device interface. The REFIID, or GUID, of the interface to the device can be obtained by using the __uuidof() macro. For example, __uuidof(ID3D12Device) will get the GUID of the interface to a device.

[out, optional] ppvDevice

Type: void**

A pointer to a memory block that receives a pointer to the ID3D12Device interface for the device.

Return value

Type: HRESULT

This method returns one of the Direct3D 12 Return Codes.

Remarks

Any returned interfaces have their reference count incremented by one, so be sure to call ::release() on the returned pointers before they are freed or else you will have a memory leak.

Examples

The D3D12Multithreading sample uses ID3D12DeviceChild::GetDevice as follows:

// Returns required size of a buffer to be used for data upload
inline UINT64 GetRequiredIntermediateSize(
    _In_ ID3D12Resource* pDestinationResource,
    _In_range_(0,D3D12_REQ_SUBRESOURCES) UINT FirstSubresource,
    _In_range_(0,D3D12_REQ_SUBRESOURCES-FirstSubresource) UINT NumSubresources)
{
    D3D12_RESOURCE_DESC Desc = pDestinationResource->GetDesc();
    UINT64 RequiredSize = 0;
    
    ID3D12Device* pDevice;
    pDestinationResource->GetDevice(__uuidof(*pDevice), reinterpret_cast<void**>(&pDevice));
    pDevice->GetCopyableFootprints(&Desc, FirstSubresource, NumSubresources, 0, nullptr, nullptr, nullptr, &RequiredSize);
    pDevice->Release();
    
    return RequiredSize;
}

Refer to the Example Code in the D3D12 Reference.

Requirements

Requirement Value
Target Platform Windows
Header d3d12.h
Library D3D12.lib
DLL D3D12.dll

See also

ID3D12DeviceChild