DXGK_SEGMENTFLAGS structure (d3dkmddi.h)

Article
08/26/2022

The DXGK_SEGMENTFLAGS structure identifies properties for a segment that the driver provides through a call to its DxgkDdiQueryAdapterInfo function.

Syntax

typedef struct _DXGK_SEGMENTFLAGS {
  union {
    struct {
      UINT Aperture : 1;
      UINT Agp : 1;
      UINT CpuVisible : 1;
      UINT UseBanking : 1;
      UINT CacheCoherent : 1;
      UINT PitchAlignment : 1;
      UINT PopulatedFromSystemMemory : 1;
      UINT PreservedDuringStandby : 1;
      UINT PreservedDuringHibernate : 1;
      UINT PartiallyPreservedDuringHibernate : 1;
      UINT DirectFlip : 1;
      UINT Use64KBPages : 1;
      UINT ReservedSysMem : 1;
      UINT SupportsCpuHostAperture : 1;
      UINT SupportsCachedCpuHostAperture : 1;
      UINT ApplicationTarget : 1;
      UINT VprSupported : 1;
      UINT VprPreservedDuringStandby : 1;
      UINT EncryptedPagingSupported : 1;
      UINT LocalBudgetGroup : 1;
      UINT NonLocalBudgetGroup : 1;
      UINT PopulatedByReservedDDRByFirmware : 1;
#if ...
      UINT Reserved : 10;
#elif
      UINT Reserved : 11;
#elif
      UINT Reserved : 21;
#else
      UINT Reserved : 22;
#endif
    };
    UINT Value;
  };
} DXGK_SEGMENTFLAGS;

Members

Aperture

[out] A UINT value that specifies whether the segment is an aperture segment instead of a memory segment. An aperture segment does not have physical pages that can hold content for an allocation. When the video memory manager pages an allocation into a memory segment, the memory manager transfers the content of the allocation from the system memory backing store to the segment location. When the video memory manager pages an allocation into an aperture segment, the memory manager maps the physical pages of the allocation backing store into the segment.

If the driver specifies this member, it must also implement the map-aperture-segment and unmap-aperture-segment operation types for its DxgkDdiBuildPagingBuffer function.

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

Agp

[out] A UINT value that specifies whether the segment is an AGP**-type aperture segment, which uses a portion of the AGP aperture that the chipset exposes. The video memory manager allocates the page for the underlying aperture and communicates with the graphic address remapping table (GART) driver to map and unmap memory for the aperture. Because only one AGP segment can exist, the driver should not specify the Agp bit-field flag with any other DXGK_SEGMENTFLAGS bit-field flags.

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

CpuVisible

[out] A UINT value that specifies whether the memory segment is accessible to the CPU at the address that is specified by the CpuTranslatedAddress member of the DXGK_SEGMENTDESCRIPTOR structure that describes the memory segment.

This member has no meaning for an aperture segment, including the AGP-type aperture segment. The only exception occurs when the user-mode display driver has not set up an alternate virtual address for a primary allocation (that is, when the driver has not set UseAlternateVA in the Flags member of the D3DDDICB_LOCKFLAGS structure during a call to the pfnLockCb function).

See Remarks for more info.

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

UseBanking

[out] A UINT value that specifies whether the segment is divided into banks that the driver uses to provide hints to the video memory manager about the placement of allocations within the segment. The driver should also specify valid bank information in the NbOfBanks and pBankRangeTable members of the DXGK_SEGMENTDESCRIPTOR structure that describes the segment.

Setting this member is equivalent to setting the fourth bit of the 32-bit Value member (0x00000008).

CacheCoherent

[out] A UINT value that specifies whether the aperture segment can maintain cache coherency with cacheable pages that are mapped into the aperture. This member can be set only with setting the Aperture member (that is, CacheCoherent has no meaning for a memory segment).

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

PitchAlignment

[out] A UINT value that specifies whether an allocation that is mapped into the segment must be pitch aligned. For this type of segment, the video memory manager uses the Size member of the DXGK_ALLOCATIONINFO structure for the allocation to allocate a backing store for the allocation. However, the video memory manager uses the PitchAlignedSize member of DXGK_ALLOCATIONINFO to allocate resources for the segment. An allocation that is targeted for this type of segment typically has a different size for the backing store and for the segment. When the backing-store size does not match the segment size, the driver must determine how to correctly move the data in the allocation. This type of segment cannot be used for eviction.

Setting this member is equivalent to setting the sixth bit of the 32-bit Value member (0x00000020).

PopulatedFromSystemMemory

[out] A UINT value that specifies whether the memory segment is actually populated from system memory that the driver allocated during initialization. If the memory segment is populated from system memory that the BIOS reserved and is not accessible to the operating system (that is, the operating system does not count this system memory when the operating system reports total amount of system memory), the driver should not set this flag. This flag is invalid and ignored on aperture segments.

Setting this member is equivalent to setting the seventh bit of the 32-bit Value member (0x00000040).

PreservedDuringStandby

[out] A UINT value that specifies whether the segment is preserved in a transition to a standby system power state.

For more information on power transition options, see Remarks.

Setting this member is equivalent to setting the eighth bit of the 32-bit Value member (0x00000080).

Supported starting with Windows 8.

PreservedDuringHibernate

[out] A UINT value that specifies whether the segment is preserved in a transition to a hibernate system power state. Do not set this flag unless the PreservedDuringStandby member is also set. For more information on power transition options, see Remarks.

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

Supported starting with Windows 8.

PartiallyPreservedDuringHibernate

[out] A UINT value that specifies whether the segment is partially preserved in a transition to a hibernate system power state. Do not set this flag unless the PreservedDuringStandby member is also set. For more information on power transition options, see Remarks.

Setting this member is equivalent to setting the tenth bit of the 32-bit Value member (0x00000200).

Supported starting with Windows 8.

DirectFlip

[out] A UINT value that specifies whether a segment supports Direct Flip allocations. In this case, the driver must ensure that Direct Flip allocations can be pinned and scanned out from this segment.

Setting this member is equivalent to setting the eleventh bit of the 32-bit Value member (0x00000400).

Supported starting with Windows 8.

Use64KBPages

[out] When set, the GPU memory segment supports 64 KB pages. Otherwise, 4 KB pages are supported. When the driver sets the cap and an allocation can be paged-in to the segment, the allocation alignment, returned by the kernel mode driver from DXGK_ALLOCATIONINFO, must be multiple a of 64 KB.