DXGKCB_GETHANDLEPARENT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// d3dkmddi.h

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-d3dkmddi-dxgkcb_gethandleparent)

DXGKCB_GETHANDLEPARENT callback function

Description

DXGKCB_GETHANDLEPARENT retrieves the parent resource from the specified allocation.

Parameters

hAllocation [in]

A handle to an allocation. This handle must be the kernel-mode handle that the DirectX graphics kernel subsystem (Dxgkrnl.sys) assigned for the allocation.

Return value

DXGKCB_GETHANDLEPARENT returns a graphics subsystem-specific handle to the parent resource for the allocation that is associated with the handle that the hAllocation parameter specifies.

If DXGKCB_GETHANDLEPARENT returns a NULL handle, Dxgkrnl.sys was unable to resolve the handle to the parent resource for a reason such as the following possibilities:

If a NULL handle is returned, the display miniport driver should fail its currently running DDI function with STATUS_INVALID_HANDLE.

Remarks

For DXGKCB_GETHANDLEPARENT to return a resource handle, the handle in hAllocation must be an allocation handle that is associated with a resource; otherwise, DXGKCB_GETHANDLEPARENT returns NULL.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbGetHandleParent via the DXGKRNL_INTERFACE.

See also

DXGKRNL_INTERFACE

View the official Windows Driver Kit DDI reference

Edit description on GitHub