Expand Minimize

GetCaptureHandle routine

Returns the handle for a specified resource that was allocated by the driver. This function also returns the size and location of specified data within the resource.


VOID APIENTRY* GetCaptureHandle(
  _In_    D3D10DDI_HDEVICE                hDevice,


hDevice [in]

A handle to the display device (graphics context).

pHandleData [in, out]

A pointer to a D3D11_1DDI_GETCAPTUREHANDLEDATA structure that defines the resource allocation.

Return value

This routine does not return a value.


Before the Microsoft Direct3D runtime calls the GetCaptureHandle function, it sets the hResource and ArrayIndex members of the D3D11_1DDI_GETCAPTUREHANDLEDATA structure to specify a resource. When this function is called, the driver updates the structure with the kernel mode allocation handle associated with the specified resource, as well as the size of the resource data and its offset within an allocated block of memory.

Note  The Direct3D runtime calls this function only for resources that were created with the D3D11_DDI_BIND_CAPTURE flag.


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform



D3d10umddi.h (include D3d10umddi.h)

See also




Send comments about this topic to Microsoft

© 2015 Microsoft