DXGK_SEGMENTFLAGS struttura (d3dkmddi.h)

Articolo
07/28/2023

La struttura DXGK_SEGMENTFLAGS identifica le proprietà per un segmento fornito dal driver tramite una chiamata alla relativa funzione DxgkDdiQueryAdapterInfo .

Sintassi

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] Valore UINT che specifica se il segmento è un segmento di apertura anziché un segmento di memoria. Un segmento di apertura non dispone di pagine fisiche che possono contenere contenuto per un'allocazione. Quando la gestione memoria video pagine un'allocazione in un segmento di memoria, gestione memoria trasferisce il contenuto dell'allocazione dall'archivio di backup della memoria di sistema alla posizione del segmento. Quando la gestione memoria video pagine un'allocazione in un segmento di apertura, gestione memoria esegue il mapping delle pagine fisiche dell'archivio di backup dell'allocazione nel segmento.

Se il driver specifica questo membro, deve anche implementare i tipi di operazione map-aperture-segment e unmap-aperture-segment per la funzione DxgkDdiBuildPagingBuffer .

L'impostazione di questo membro equivale a impostare il primo bit del membro Valore a 32 bit (0x00000001).

Agp

[out] Valore UINT che specifica se il segmento è un segmento di apertura AGP**type, che usa una parte dell'apertura AGP esposta dal chipset. La gestione memoria video alloca la pagina per l'apertura sottostante e comunica con il driver garT (Graphic Address Remapping Table) per eseguire il mapping e la memoria non mappata per l'apertura. Poiché esiste un solo segmento AGP, il driver non deve specificare il flag di campo a bit Agp con qualsiasi altro flag di campo a bit DXGK_SEGMENTFLAGS.

L'impostazione di questo membro equivale a impostare il secondo bit del membro Valore a 32 bit (0x00000002).

CpuVisible

[out] Valore UINT che specifica se il segmento di memoria è accessibile alla CPU all'indirizzo specificato dal membro CpuTranslatedAddress della struttura DXGK_SEGMENTDESCRIPTOR che descrive il segmento di memoria.

Questo membro non ha alcun significato per un segmento di apertura, incluso il segmento di apertura di tipo AGP. L'unica eccezione si verifica quando il driver di visualizzazione in modalità utente non ha configurato un indirizzo virtuale alternativo per un'allocazione primaria, ovvero quando il driver non ha impostato UseAlternateVA nel membro Flag della struttura D3DDDICB_LOCKFLAGS durante una chiamata alla funzione pfnLockCb .

Per altre informazioni, vedere Osservazioni.

L'impostazione di questo membro equivale a impostare il terzo bit del membro Valore a 32 bit (0x00000004).

UseBanking

[out] Valore UINT che specifica se il segmento è diviso in banche usate dal driver per fornire hint al gestore della memoria video sulla posizione delle allocazioni all'interno del segmento. Il driver deve specificare anche informazioni bancarie valide nei membri NbOfBanks e pBankRangeTable della struttura DXGK_SEGMENTDESCRIPTOR che descrive il segmento.

L'impostazione di questo membro equivale a impostare il quarto bit del membro Valore a 32 bit (0x00000008).

CacheCoherent

[out] Valore UINT che specifica se il segmento di apertura può mantenere la coesistenza della cache con pagine memorizzate nella cache mappate all'apertura. Questo membro può essere impostato solo con l'impostazione del membro Aperture , ovvero CacheCoherent non ha alcun significato per un segmento di memoria.

L'impostazione di questo membro equivale a impostare il quinto bit del membro Valore a 32 bit (0x00000010).

PitchAlignment

[out] Valore UINT che specifica se un'allocazione mappata nel segmento deve essere allineata. Per questo tipo di segmento, gestione memoria video usa il membro Size della struttura di DXGK_ALLOCATIONINFO per l'allocazione per allocare un archivio di backup per l'allocazione. Tuttavia, la gestione memoria video usa il membro PitchAlignedSize di DXGK_ALLOCATIONINFO per allocare le risorse per il segmento. Un'allocazione destinata a questo tipo di segmento in genere ha dimensioni diverse per l'archivio di backup e per il segmento. Quando le dimensioni dell'archivio di backup non corrispondono alle dimensioni del segmento, il driver deve determinare come spostare correttamente i dati nell'allocazione. Impossibile usare questo tipo di segmento per la rimozione.

L'impostazione di questo membro equivale a impostare il sesto bit del membro Valore a 32 bit (0x00000020).

PopulatedFromSystemMemory

[out] Valore UINT che specifica se il segmento di memoria viene effettivamente popolato dalla memoria di sistema allocata dal driver durante l'inizializzazione. Se il segmento di memoria viene popolato dalla memoria di sistema riservata dal BIOS e non è accessibile al sistema operativo, ovvero il sistema operativo non conta questa memoria di sistema quando il sistema operativo segnala la quantità totale di memoria di sistema, il driver non deve impostare questo flag. Questo flag non è valido e ignorato nei segmenti di apertura.

L'impostazione di questo membro equivale a impostare il settimo bit del membro Value a 32 bit (0x00000040).

PreservedDuringStandby

[out] Valore UINT che specifica se il segmento viene mantenuto in una transizione a uno stato di alimentazione del sistema di standby.

Per altre informazioni sulle opzioni di power transition, vedere Osservazioni.

L'impostazione di questo membro equivale a impostare l'ottavo bit del membro Valore a 32 bit (0x00000080).

Supportato a partire da Windows 8.

PreservedDuringHibernate

[out] Valore UINT che specifica se il segmento viene mantenuto in una transizione a uno stato di alimentazione del sistema di ibernazione. Non impostare questo flag a meno che il membro PreservedDuringStandby non sia impostato. Per altre informazioni sulle opzioni di power transition, vedere Osservazioni.

L'impostazione di questo membro equivale a impostare il nono bit del membro Valore a 32 bit (0x00000100).

Supportato a partire da Windows 8.

PartiallyPreservedDuringHibernate

[out] Valore UINT che specifica se il segmento viene parzialmente mantenuto in una transizione a uno stato di alimentazione del sistema di ibernazione. Non impostare questo flag a meno che il membro PreservedDuringStandby non sia impostato. Per altre informazioni sulle opzioni di power transition, vedere Osservazioni.

L'impostazione di questo membro equivale a impostare il decimo bit del membro Valore a 32 bit (0x00000200).

Supportato a partire da Windows 8.

DirectFlip

[out] Valore UINT che specifica se un segmento supporta le allocazioni Direct Flip. In questo caso, il driver deve assicurarsi che le allocazioni direct Flip possano essere aggiunte e analizzate da questo segmento.

L'impostazione di questo membro equivale a impostare l'undicesimo bit del membro Valore a 32 bit (0x00000400).

Supportato a partire da Windows 8.

Use64KBPages

[out] Se impostato, il segmento di memoria GPU supporta 64 pagine KB. In caso contrario, sono supportate 4 pagine KB. Quando il driver imposta il limite e un'allocazione può essere impaginato nel segmento, l'allineamento dell'allocazione, restituito dal driver in modalità kernel da DXGK_ALLOCATIONINFO, deve essere più di 64 KB.