DXGKDDI_PROTECTED_CALLBACK fungsi panggilan balik (dispmprt.h)
Rutinitas panggilan balik DxgkProtectedCallback diimplementasikan oleh driver miniport tampilan dan dipanggil oleh DxgkCbExcludeAdapterAccess selama status terproteksi ketika semua akses ke adaptor tampilan dicegah.
Sintaks
DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;
void DxgkddiProtectedCallback(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] PVOID ProtectedCallbackContext,
[in] NTSTATUS ProtectionStatus
)
{...}
Parameter
[in] MiniportDeviceContext
Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX.
[in] ProtectedCallbackContext
Penunjuk ke informasi yang ditentukan driver yang ditentukan dalam panggilan sebelumnya ke DxgkCbExcludeAdapterAccess.
[in] ProtectionStatus
Status status terproteksi adaptor tampilan. Jika STATUS_SUCCESS, adaptor berhasil dilindungi dari akses. Kode status kegagalan menunjukkan bahwa adaptor tidak dilindungi.
Menampilkan nilai
Tidak ada
Keterangan
DxgkProtectedCallback harus dipanggil hanya ketika semua akses ke adaptor tampilan telah dihentikan, seperti yang ditunjukkan oleh parameter status ProtectionStatus.
Driver harus memastikan bahwa kondisi berikut terpenuhi selama rutinitas panggilan balik:
- Semua gangguan pada perangkat dinonaktifkan, dan gangguan tertunda yang tersisa ditangani, termasuk DPC apa pun yang mungkin telah diantrekan pada CPU apa pun tetapi belum dilayanakan.
- Semua memori gabungan tulis dan status terkait cache lainnya telah dibersihkan.
- Setiap peristiwa ACPI atau BIOS/SMI yang terjadi tidak mengakses perangkat keras.
- Koherensi dicapai antara semua adaptor dalam konfigurasi status adaptor tertaut.
- Adaptor, termasuk register dan mode tampilannya, dipertahankan dalam keadaan yang tepat untuk menangani buffer DMA yang terjadi pada pengembalian dari rutinitas DxgkProtectedCallback . Driver tidak boleh mengubah status atau kemampuan aplikasi apa pun yang terlihat.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Desktop |
| Header | dispmprt.h (termasuk Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |