Fungsi D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
Fungsi D3DKMTInvalidateActiveVidPn membatalkan jaringan saji video aktif (VidPN) yang saat ini digunakan.
Catatan
Fungsi ini usang di Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Sintaks
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Parameter
[in] unnamedParam1
Penunjuk ke struktur D3DKMT_INVALIDATEACTIVEVIDPN yang menjelaskan parameter yang membatalkan VidPN aktif yang saat ini digunakan.
Nilai kembali
D3DKMTInvalidateActiveVidPn mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_SUCCESS | VidPN yang saat ini sedang digunakan berhasil dibatalkan. |
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Tidak ada adaptor grafis yang ditentukan di anggota hAdapter D3DKMT_INVALIDATEACTIVEVIDPN untuk membatalkan VidPN. |
STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn tidak dapat diselesaikan karena memori yang tidak mencukupi. |
STATUS_NOT_SUPPORTED | Mode tampilan yang diminta oleh driver klien yang dapat diinstal OpenGL (ICD) dalam buffer yang diarahkan oleh anggota D3DKMT_INVALIDATEACTIVEVIDPN pPrivateDriverData tidak didukung oleh driver miniport tampilan. Nilai status ini juga akan dikembalikan jika fungsi ini dipanggil pada komputer yang menjalankan Windows 7 dan yang lebih baru oleh driver miniport tampilan dengan DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
STATUS_DEVICE_REMOVED | Adapter grafis dihentikan. |
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | Driver miniport tampilan tidak merekomendasikan VidPN untuk menggantikan VidPN yang saat ini sedang digunakan. |
Fungsi ini mungkin juga mengembalikan nilai NTSTATUS lainnya.
Keterangan
Ketika fungsi D3DKMTInvalidateActiveVidPn dipanggil untuk membatalkan VidPN yang saat ini digunakan, VidPN saat ini diganti dengan VidPN baru yang direkomendasikan driver miniport tampilan. Karena driver miniport tampilan harus merekomendasikan VidPN baru, driver miniport tampilan harus dapat menentukan mode tampilan yang diperlukan OpenGL ICD dari buffer yang diarahkan oleh anggota pPrivateDriverDatadari D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD dapat memanggil D3DKMTInvalidateActiveVidPn untuk mode tampilan (misalnya, mode tampilan kloning) yang tidak didukung dengan menggunakan panggilan yang lebih umum ke fungsi D3DKMTSetDisplayMode .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows untuk menampilkan driver miniport dengan versi < DXGKDDI_INTERFACE_VERSION_WIN7. |
Target Platform | Universal |
Header | d3dkmthk.h (termasuk D3dkmthk.h) |
Pustaka | Gdi32.lib |
DLL | Gdi32.dll |