struktur DXGK_ALLOCATIONLIST (d3dkmddi.h)

Artikel
03/08/2023

Struktur DXGK_ALLOCATIONLIST menjelaskan spesifikasi alokasi yang digunakan dalam buffering akses memori langsung (DMA).

Sintaks

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;

Anggota

[in/out] hDeviceSpecificAllocation

Handel terbuka untuk alokasi yang sedang direferensikan (yaitu, handel yang dikembalikan driver di anggota hDeviceSpecificAllocation dari struktur DXGK_OPENALLOCATIONINFO untuk alokasi dalam panggilan ke fungsi DxgkDdiOpenAllocation driver).

[in/out] WriteOperation

Mengidentifikasi apakah alokasi dapat ditulis. Mengatur anggota ini ke 1 menunjukkan bahwa alokasi dapat ditulis ke mana saja di buffer DMA. Mengatur anggota ini setara dengan mengatur bit pertama dari nilai 32-bit (0x00000001).

[in/out] SegmentId

Menentukan pengidentifikasi segmen tempat alokasi terakhir diisi. Mengatur anggota ini ke 0 menunjukkan bahwa tidak ada informasi pra-patching yang tersedia. Mengatur anggota ini setara dengan mengatur bit kedua hingga keenam dari nilai 32-bit (0x0000002E).

[in] Reserved

Dicadangkan. Anggota ini harus diatur ke 0. Mengatur anggota ini setara dengan mengatur 26 bit yang tersisa (0xFFFFFFC0) dari nilai 32-bit ke nol.

[in/out] PhysicalAddress

Jenis data PHYSICAL_ADDRESS (yang didefinisikan sebagai LARGE_INTEGER) yang menunjukkan alamat fisik, dalam segmen yang ditentukan SegmentId , tempat alokasi terakhir di-paged-in. Anggota ini diatur ke nol jika tidak ada informasi pra-patching yang tersedia.

Didukung dimulai dengan Windows 10.

[in/out] VirtualAddress

Jenis data D3DGPU_VIRTUAL_ADDRESS (yang didefinisikan sebagai ULONGLONG) yang menunjukkan alamat virtual.

Didukung dimulai dengan Windows 10.

Keterangan

Dalam fungsi DxgkDdiRender driver miniport tampilan, driver menghasilkan daftar struktur DXGK_ALLOCATIONLIST untuk spesifikasi alokasi yang akan digunakan dalam buffer akses memori langsung (DMA). Manajer memori video menggunakan daftar untuk memisahkan dan mem-patch buffer DMA dengan tepat.