DXGKDDI_SUBMITCOMMAND fungsi panggilan balik (d3dkmddi.h)
Fungsi DxgkDdiSubmitCommand mengirimkan buffer akses memori langsung (DMA) ke unit eksekusi perintah perangkat keras.
Sintaks
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
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] pSubmitCommand
Penunjuk ke struktur DXGKARG_SUBMITCOMMAND yang menjelaskan buffer DMA yang dikirimkan driver miniport tampilan ke unit eksekusi perintah perangkat keras.
Menampilkan nilai
DxgkDdiSubmitCommand mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan. Jika driver mengembalikan kode kesalahan, sistem operasi menyebabkan terjadinya bugcheck sistem. Lihat Keterangan.
Keterangan
Karena operasi paging dianggap sebagai operasi sistem, operasi tersebut tidak terkait dengan konteks aplikasi atau konteks grafis tertentu. Oleh karena itu, ketika pengiriman adalah untuk operasi paging, fungsi DxgkDdiSubmitCommand dipanggil dengan NULL yang ditentukan dalam anggota hDevice dari struktur DXGKARG_SUBMITCOMMAND yang dituju parameter pSubmitCommand .
Namun, jika arsitektur perangkat keras dan driver tertentu harus memiliki perangkat secara internal, driver harus membuat perangkat secara internal selama inisialisasi adaptor dan harus menjaga perangkat secara internal sebagai perangkat default sistem untuk digunakan dalam operasi penomoran halaman.
Driver dapat menulis nilai yang disediakan dalam anggota SubmissionFenceId dari DXGKARG_SUBMITCOMMAND ke dalam perintah pagar di buffer cincin. Untuk informasi selengkapnya tentang perintah pagar, lihat Menyediakan Pengidentifikasi Pagar.
Jika driver mengembalikan kode kesalahan, subsistem kernel grafis DirectX menyebabkan terjadinya bugcheck sistem. Dalam file crash dump, kesalahan dicatat oleh pesan BugCheck 0x119, yang akan memiliki empat parameter berikut.
- 0x2 (mengidentifikasi penyebab kesalahan)
- Kode kesalahan NTSTATUS yang dikembalikan dari panggilan driver yang gagal
- Penunjuk ke struktur DXGKARG_SUBMITCOMMAND
- Penunjuk ke struktur data penjadwal internal
DxgkDdiSubmitCommand harus dibuat tidak dapat diperbaiki karena berjalan di IRQL = DISPATCH_LEVEL.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |