DxgkCbGetHandleParent

DxgkCbGetHandleParent routine

The DxgkCbGetHandleParent function retrieves the parent resource from the specified allocation.

Syntax


DXGKCB_GETHANDLEPARENT DxgkCbGetHandleParent;

D3DKMT_HANDLE APIENTRY DxgkCbGetHandleParent(
  _In_ D3DKMT_HANDLE hAllocation
)
{ ... }

Parameters

hAllocation [in]

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

Return value

DxgkCbGetHandleParent 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 DxgkCbGetHandleParent returns a NULL handle, the DirectX graphics kernel subsystem was unable to resolve the handle to the parent resource because, for example, of the following possible reasons:

  • An invalid handle was received from the user-mode display driver because of a malicious attack or some other bug.
  • Allocations had lifetime issues.

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

Remarks

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

Requirements

Target platform

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

< DISPATCH_LEVEL

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft