Edit

Share via

DXGKARG_VALIDATEUPDATEALLOCPROPERTY structure (d3dkmddi.h)

  • Article

The DXGKARG_VALIDATEUPDATEALLOCPROPERTY structure holds the information needed to validate the parameters to update the properties of an allocation.

Syntax

typedef struct _DXGKARG_VALIDATEUPDATEALLOCPROPERTY {
  [in] HANDLE                           hAllocation;
  [in] UINT                             SupportedSegmentSet;
  [in] D3DDDI_SEGMENTPREFERENCE         PreferredSegment;
  [in] D3DDDI_UPDATEALLOCPROPERTY_FLAGS Flags;
  union {
    struct {
      UINT SetAccessedPhysically : 1;
      UINT SetSupportedSegmentSet : 1;
      UINT SetPreferredSegment : 1;
      UINT Reserved : 29;
    };
         UINT PropertyMaskValue;
  };
} DXGKARG_VALIDATEUPDATEALLOCPROPERTY;

Members

[in] hAllocation

A handle to the allocation that will be updated.

[in] SupportedSegmentSet

An index for the new supported segment set. If the current supported segment set is the same, then this will be ignored.

[in] PreferredSegment

An index for the new preferred segment set. If the current preferred segment set is the same, then this will be ignored.

[in] Flags

The flags that will be used to update the allocation.

SetAccessedPhysically

A UINT value that specifies whether the allocation is accessed by its physical address.

Setting this member is equivalent to setting the first bit of the 32-bit PropertyMaskValue member (0x00000001).

SetSupportedSegmentSet

A UINT value that specifies whether the supported segment is set to a new value.

Setting this member is equivalent to setting the second bit of the 32-bit PropertyMaskValue member (0x00000010).

SetPreferredSegment

A UINT value that specifies whether the preferred segment is set to a new value.

Setting this member is equivalent to setting the third bit of the 32-bit PropertyMaskValue member (0x00000100).

Reserved

This member is reserved and should be set to zero. Setting this member to zero is equivalent to setting the remaining 29 bits (0xFFFFFFFE) of the 32-bit PropertyMaskValue member to zeros.

PropertyMaskValue

A member in the union that is contained in D3DDDI_UPDATEALLOCPROPERTY that can hold one 32-bit value that identifies how to update an allocation.

Requirements

Requirement Value
Minimum supported client Windows 10
Header d3dkmddi.h