Metode IWDFDeviceInitialize::AutoForwardCreateCleanupClose (wudfddi.h)

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode AutoForwardCreateCleanupClose mengontrol saat membuat, membersihkan, dan menutup pemberitahuan diteruskan ke driver bawah berikutnya di tumpukan perangkat.

Sintaks

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Parameter

[in] State

Nilai yang diketik WDF_TRI_STATE yang mengidentifikasi status penerusan otomatis. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
WdfUseDefault (0)	Kerangka kerja menggunakan skema penerusan default. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
WdfFalse (1)	Kerangka kerja tidak meneruskan membuat, membersihkan, dan menutup pemberitahuan ke driver bawah berikutnya.
WdfTrue (2)	Kerangka kerja secara sinkron meneruskan pembuatan, pembersihan, dan menutup pemberitahuan ke driver bawah berikutnya.

Nilai kembali

Tidak ada

Keterangan

Jika driver UMDF melewati WdfUseDefault untuk parameter Status dalam panggilan ke AutoForwardCreateCleanupClose, kerangka kerja menggunakan skema penerusan default untuk membuat, membersihkan, dan menutup pemberitahuan yang bergantung pada apakah driver adalah driver filter atau fungsi:

• Jika driver adalah driver filter, skema penerusan default adalah meneruskan pemberitahuan secara sinkron ke driver bawah berikutnya.
• Jika driver adalah driver fungsi, skema penerusan default adalah tidak meneruskan pemberitahuan ke driver yang lebih rendah berikutnya.

Jika kerangka kerja disiapkan untuk penerusan, kerangka kerja meneruskan pembersihan dan menutup pemberitahuan terlepas dari apakah driver mendukung metode antarmuka IFileCallbackCleanup::OnCleanupFile dan IFileCallbackClose::OnCloseFile . Namun, kerangka kerja secara otomatis meneruskan permintaan buat hanya jika driver tidak mendukung metode IQueueCallbackCreate::OnCreateFile . Jika driver mendukung IQueueCallbackCreate::OnCreateFile, kerangka kerja meneruskan permintaan hanya jika driver secara eksplisit mengatur penerusan (WdfTrue) ke driver yang lebih rendah berikutnya.

Untuk informasi selengkapnya tentang bagaimana driver UMDF menggunakan AutoForwardCreateCleanupClose, lihat Mencegah Ketidakseimbangan Buat dan Tutup Pemberitahuan ke Driver.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize