struktur DXGK_VIDMMCAPS (d3dkmddi.h)
Struktur DXGK_VIDMMCAPS mengidentifikasi kemampuan manajemen memori video yang didukung driver miniport tampilan.
Sintaks
typedef struct _DXGK_VIDMMCAPS {
union {
struct {
UINT OutOfOrderLock : 1;
UINT DedicatedPagingEngine : 1;
UINT PagingEngineCanSwizzle : 1;
UINT SectionBackedPrimary : 1;
UINT CrossAdapterResource : 1;
UINT VirtualAddressingSupported : 1;
UINT GpuMmuSupported : 1;
UINT IoMmuSupported : 1;
UINT ReplicateGdiContent : 1;
UINT NonCpuVisiblePrimary : 1;
UINT ParavirtualizationSupported : 1;
UINT IoMmuSecureModeSupported : 1;
UINT DisableSelfRefreshVRAMInS3 : 1;
UINT IoMmuSecureModeRequired : 1;
UINT MapAperture2Supported : 1;
UINT CrossAdapterResourceTexture : 1;
UINT CrossAdapterResourceScanout : 1;
UINT AlwaysPoweredVRAM : 1;
#if ...
UINT Reserved : 14;
#elif
UINT Reserved : 15;
#elif
UINT Reserved : 18;
#elif
UINT Reserved : 19;
#elif
UINT Reserved : 21;
#elif
UINT Reserved : 22;
#elif
UINT Reserved : 27;
#elif
UINT Reserved : 28;
#else
UINT Reserved : 31;
#endif
};
UINT Value;
};
UINT PagingNode;
} DXGK_VIDMMCAPS;
Anggota
OutOfOrderLock
Menentukan apakah driver dapat mengunci instans alokasi selain instans terbaru. Driver biasanya menetapkan nilai ini untuk utas DDI dan penyeimbangan beban jika utas DDI harus mengunci buffer vertex yang sebelumnya telah dikunci dan dibuang oleh utas aplikasi. Mengatur anggota ini setara dengan mengatur bit pertama anggota Nilai 32-bit (0x00000001).
DedicatedPagingEngine
Anggota ini dicadangkan dan harus diatur ke nol.
PagingEngineCanSwizzle
Anggota ini dicadangkan dan harus diatur ke nol.
SectionBackedPrimary
Menentukan apakah driver mendukung alokasi utama yang didukung bagian. Didukung dimulai dengan Windows 8.
CrossAdapterResource
Menentukan apakah driver menyediakan dukungan tingkat 1 untuk menyalin ke dan dari sumber daya lintas adaptor dalam sistem< hibrid. Didukung dimulai dengan Windows 8.1.
Mulai dari WDDM 2.4, DXGI memungkinkan pengoptimalan presentasi hibrid saat ini untuk skenario yang lebih luas di mana pun penyajian berada pada satu GPU dan menyajikan pada monitor GPU lain. Ini hanya dimungkinkan jika kedua GPU mendukung sumber daya lintas adaptor.
Properti sumber daya adaptor silang tercantum di bawah ini.
- Sumber daya hanya dapat di-paged-in ke segmen memori GPU aperture
- Sumber daya dialokasikan sebagai bersama.
- Sumber daya harus ditandai CPU Terlihat.
- Alokasi akan dibuat oleh OS sebagai gabungan penulisan.
- Sumber daya hanya memiliki satu alokasi dan memiliki format linier.
- Sumber daya memiliki perataan pitch standar (128 byte). Definisi D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT ditambahkan untuk perataan pitch. Sumber daya harus dibuat pada kelipatan terkecil dari perataan ini yang akan berisi konten sumber daya.
- Sumber daya memiliki perataan tinggi standar (4 baris). D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT ditambahkan. Sumber daya harus dibuat pada kelipatan terkecil dari perataan ini yang akan berisi konten sumber daya.
#define D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT 128
#define D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT 4
- Alamat awal memori sumber daya diselaraskan ke batas satu halaman.
- Sumber daya mungkin dibuat sebagai alokasi standar dari mode kernel dan kemudian dibuka oleh UMD.
- Sumber daya mungkin dibuat oleh UMD.
Alokasi adaptor silang dapat digunakan sebagai primer, tetapi driver tidak akan mendapatkan informasi, yang biasanya disediakan ketika primer dibuat
VirtualAddressingSupported
Menentukan apakah driver mendukung alamat memori virtual. Untuk mengekspresikan dukungan untuk alamat memori virtual GPU, driver harus mengatur batas VirtualAddressingSupported dan batas GpuMmuSupported atau IoMmuSupported . GpuMmuSupported dan IoMmuSupported tidak dapat diatur secara bersamaan. Didukung dimulai dengan Windows 10.
GpuMmuSupported
Menentukan apakah adaptor mendukung model GpuMmu . Adaptor tidak dapat mendukung model GpuMmu dan IoMmu pada mesin yang berbeda secara bersamaan. Lihat Model GpuMmu untuk informasi selengkapnya. Didukung dimulai dengan Windows 10.
IoMmuSupported
Menentukan apakah adaptor mendukung model IoMmu . Adaptor tidak dapat mendukung model GpuMmu dan IoMmu pada mesin yang berbeda secara bersamaan. Lihat Model IoMmu untuk informasi selengkapnya. Didukung dimulai dengan Windows 10 (WDDM 2.0).
ReplicateGdiContent
Menentukan apakah adaptor mendukung replikasi konten GDI. Didukung dimulai dengan Windows 10.
NonCpuVisiblePrimary
Menunjukkan bahwa alokasi GDI tidak diperlukan agar CPU terlihat. Didukung dimulai dengan Windows 10.
ParavirtualizationSupported
KMD host perlu mengatur batas jika semua DDI diimplementasikan. Didukung dimulai dengan Windows 10 versi 1703 (WDDM 2.2).
IoMmuSecureModeSupported
Menunjukkan bahwa driver mendukung isolasi GPU berbasis IOMMU. Didukung dimulai dengan Windows 10 versi 1803 (WDDM 2.4).
DisableSelfRefreshVRAMInS3
Nonaktifkan dukungan untuk refresh mandiri VRAM di S3. Didukung dimulai dengan Windows 10 versi 1803.
IoMmuSecureModeRequired
Menunjukkan bahwa dukungan perangkat keras dan isolasi IOMMU (disebut oleh bendera IommuSecureModeSupported ) diperlukan atau OS tidak akan memulai adaptor. Didukung dimulai dengan Windows 10 versi 2004 (WDDM 2.7).
MapAperture2Supported
Menunjukkan bahwa driver mendukung operasi DXGK_OPERATION_MAP_APERTURE_SEGMENT2 paging buffer, yang diperlukan untuk remapping IOMMU DMA. Didukung dimulai dengan WDDM versi 2.9.
CrossAdapterResourceTexture
Menentukan apakah driver menyediakan dukungan teksur tingkat 2 dari sumber daya lintas adaptor. Driver yang menunjukkan dukungan untuk CrossAdapterResourceTexture juga harus menunjukkan dukungan untuk CrossAdapterResource. Didukung dimulai dengan WDDM versi 2.9.
CrossAdapterResourceScanout
Menentukan apakah driver menyediakan dukungan tingkat 3 untuk memindai sumber daya lintas adaptor. Driver yang menunjukkan dukungan untuk CrossAdapterResourceScanout juga harus menunjukkan dukungan untuk CrossAdapterResource dan CrossAdapterResourceTexture. Didukung dimulai dengan WDDM versi 2.9.
Dukungan Tier 3 mengharuskan driver dapat melakukan kemampuan membalik yang didukung, yang dideklarasikan oleh driver di DXGK_FLIPCAPS, untuk sumber daya lintas adaptor dari spesifikasi minimum berikut:
- Ukuran buffer primer lintas adaptor 1920 x 1080 atau lebih kecil
- Format piksel buffer dari salah satu format DisplayScanOut yang didukung berikut ini:
- DXGI_FORMAT_R16G16B16A16_FLOAT
- DXGI_FORMAT_R10G10B10A2_UNORM
- DXGI_FORMAT_R8G8B8A8_UNORM
- DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
- DXGI_FORMAT_B8G8R8A8_UNORM
- DXGI_FORMAT_R10G10B10_XR_BIAS_A2_UNORM
- DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
Runtime DXGI akan meminta dukungan CrossAdapterResourceScanout driver dan jika didukung, tumpukan presentasi akan turun ke 1 jalur salinan. Oleh karena itu, driver yang mendeklarasikan dukungan untuk CrossAdapterResourceScanout juga diperlukan untuk:
- Mendukung DXGKDDI_CHECKMULTIPLANEOVERLAYSUPPORT3.
- Dukung semua DDI terkait presentasi yang relevan untuk primaer lintas adaptor dari spesifikasi minimum di atas. Beberapa contohnya adalah pfnCreateResource, pfnCheckMultiplaneOverlaySupport dan pfnPresentMultiplaneOverlay/pfnPresent1. Silakan lihat spesifikasi yang ada untuk detail yang diperlukan, seperti spesifikasi MPO dan spesifikasi Hibrid. Silakan lihat bagian di bawah ini untuk detail lebih lanjut tentang jatuh dari CASO.
AlwaysPoweredVRAM
Reserved
Anggota ini dicadangkan dan harus diatur ke nol. Mengatur anggota ini ke nol setara dengan mengatur 31 bit yang tersisa (setelah mengatur OutOfOrderLock) dari anggota Nilai ke nol. Perhatikan bahwa Cadangan hanya tersedia jika DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7.
Value
Nilai ini digunakan untuk beroperasi atas anggota secara kolektif.
PagingNode
Indeks nol berbasis simpul yang digunakan untuk operasi penomorian halaman. Jika driver tidak mengatur anggota bit-field MultiEngineAware dari anggota SchedulingCaps dari struktur DXGK_DRIVERCAPS , subsistem kernel grafis DirectX mengabaikan pengaturan PagingNode. Anggota ini hanya berlaku untuk WDDM 1.x. Di WDDM 2.x, PagingNode dipindahkan ke DXGK_PHYSICALADAPTERCAPS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Header | d3dkmddi.h (termasuk D3dkmddi.h) |