struttura DXGK_ALLOCATIONLIST (d3dkmddi.h)

Articolo
02/06/2025

La struttura DXGK_ALLOCATIONLIST descrive una specifica di allocazione usata nel buffer DMA (Direct Memory Access).

Sintassi

typedef struct _DXGK_ALLOCATIONLIST
{
    HANDLE              hDeviceSpecificAllocation;
    struct
    {
        UINT            WriteOperation  : 1;    // 0x00000001
        UINT            SegmentId       : 5;    // 0x0000002E
        UINT            Reserved        : 26;   // 0xFFFFFFC0
    };
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM2_0)
    union
    {
        PHYSICAL_ADDRESS        PhysicalAddress;
        D3DGPU_VIRTUAL_ADDRESS  VirtualAddress;
    };
#else // (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WDDM2_0)
    PHYSICAL_ADDRESS    PhysicalAddress;
#endif // (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM2_0)
} DXGK_ALLOCATIONLIST;

Membri

[in/out] hDeviceSpecificAllocation

Handle aperto per l'allocazione a cui viene fatto riferimento, ovvero l'handle restituito dal driver nella hDeviceSpecificAllocation membro della struttura DXGK_OPENALLOCATIONINFO per l'allocazione in una chiamata alla funzione DxgkDdiOpenAl location del driver.

[in/out] WriteOperation

Identifica se l'allocazione può essere scritta in . L'impostazione di questo membro su 1 indica che l'allocazione può essere scritta in qualsiasi punto del buffer DMA. L'impostazione di questo membro equivale all'impostazione del primo bit di un valore a 32 bit (0x00000001).

[in/out] SegmentId

Specifica l'identificatore di un segmento in cui è stata inserita l'ultima pagina dell'allocazione. L'impostazione di questo membro su 0 indica che non sono disponibili informazioni di pre-applicazione di patch. L'impostazione di questo membro equivale all'impostazione del secondo al sesto bit di un valore a 32 bit (0x0000002E).

[in] Reserved

Riservato. Questo membro deve essere impostato su 0. L'impostazione di questo membro equivale all'impostazione dei rimanenti 26 bit (0xFFFFFFC0) di un valore a 32 bit su zeri.

[in/out] PhysicalAddress

Tipo di dati PHYSICAL_ADDRESS (definito come LARGE_INTEGER) che indica l'indirizzo fisico, all'interno del segmento che SegmentId specifica, dove l'allocazione è stata inserita nell'ultima pagina in corrispondenza di . Questo membro è impostato su zero se non sono disponibili informazioni di pre-applicazione di patch.

Supportato a partire da Windows 10.

[in/out] VirtualAddress

Tipo di dati D3DGPU_VIRTUAL_ADDRESS (definito come ULONGLONG) che indica l'indirizzo virtuale.

Supportato a partire da Windows 10.

Osservazioni

Nella funzionedel driver miniport di visualizzazioneDxgkDdiRender, il driver genera un elenco di strutture DXGK_ALLOCATIONLIST per le specifiche di allocazione che verranno usate in un buffer DMA (Direct Memory Access). Gestione memoria video usa l'elenco per suddividere e applicare patch ai buffer DMA in modo appropriato.