DXGKDDI_RELEASESWIZZLINGRANGE fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi DxgkDdiReleaseSwizzlingRange merilis rentang mendengung yang sebelumnya disiapkan oleh fungsi DxgkDdiAcquireSwizzlingRange .

Sintaks

DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;

NTSTATUS DxgkddiReleaseswizzlingrange(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX di parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in] pReleaseSwizzlingRange

Penunjuk ke struktur DXGKARG_RELEASESWIZZLINGRANGE yang berisi informasi untuk melepaskan rentang yang menggeliat.

Menampilkan nilai

DxgkDdiReleaseSwizzlingRange mengembalikan STATUS_SUCCESS, atau hasil kesalahan yang sesuai jika rentang yang menyilaukan tidak berhasil dirilis.

Keterangan

Fungsi DxgkDdiReleaseSwizzlingRange biasanya dipanggil ketika alokasi yang ditentukan (yaitu, anggota hAllocation dari struktur DXGKARG_RELEASESWIZZLINGRANGE yang ditunjukkan oleh parameter pReleaseSwizzlingRange ) dikeluarkan atau dihancurkan, atau ketika alokasi lain memerlukan rentang menyibukkan yang ditentukan anggota RangeId DXGKARG_RELEASESWIZZLINGRANGE.

Jika alokasi yang ditentukan saat ini dikaitkan dengan beberapa rentang yang menggeliat (melalui panggilan ke fungsi DxgkDdiAcquireSwizzlingRange ), driver miniport tampilan hanya boleh melepaskan rentang menggeser yang ditentukan anggota RangeId DXGKARG_RELEASESWIZZLINGRANGE. Jika driver miniport tampilan merilis semua rentang menggeser yang terkait dengan alokasi, kerusakan acak dalam alokasi dapat mengakibatkan karena aplikasi saat ini mungkin menggunakan satu atau beberapa rentang yang menggeser.

Driver harus menggunakan I/O yang dipetakan memori (MMIO) untuk mengatur rentang yang menggeliat. Akses rentang berdengung ini tidak boleh mengganggu eksekusi GPU (yaitu, GPU tidak boleh menganggur ketika DxgkDdiReleaseSwizzlingRange dipanggil).

Semua panggilan ke DxgkDdiReleaseSwizzlingRange diserialisasikan di antara mereka sendiri tetapi tidak dengan fungsi antarmuka driver perangkat (DDI) lainnya.

DxgkDdiReleaseSwizzlingRange harus dibuat dapat dipaginasi.