PFND3D11_1DDI_GETCAPTUREHANDLE callback function

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.


PFND3D11_1DDI_GETCAPTUREHANDLE Pfnd3d111DdiGetcapturehandle;

void Pfnd3d111DdiGetcapturehandle(
  D3D10DDI_HDEVICE hDevice,



A handle to the display device (graphics context).


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

Return Value

This callback function 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 Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See Also