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

Lihat juga

D3DKMTSetDisplayMode

D3DKMT_INVALIDATEACTIVEVIDPN