Fungsi WdfDeviceSetStaticStopRemove (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceSetStaticStopRemove menginformasikan kerangka kerja apakah perangkat dapat dihentikan dan dihapus.

Sintaks

void WdfDeviceSetStaticStopRemove(
  [in] WDFDEVICE Device,
  [in] BOOLEAN   Stoppable
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] Stoppable

Nilai Boolean yang menunjukkan apakah perangkat yang ditentukan dapat dihentikan dan dihapus. Jika TRUE, perangkat dapat dihentikan dan dihapus. Jika FALSE, perangkat tidak dapat dihentikan dan dihapus.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Secara default, perangkat dapat dihentikan dan dihapus. Oleh karena itu, driver biasanya memanggil WdfDeviceSetStaticStopRemove hanya jika harus mengatur parameter Stoppable untuk sementara ke FALSE. Misalnya, driver yang mengontrol penulis DVD mungkin memanggil WdfDeviceSetStaticStopRemove dengan Stoppable diatur ke FALSE sebelum mulai membakar DVD. Setelah driver selesai membakar DVD, ia akan memanggil WdfDeviceSetStaticStopRemove lagi dengan Stoppable diatur ke TRUE.

Jika perangkat driver Anda mendukung file khusus (lihat WdfDeviceSetSpecialFileSupport), kerangka kerja tidak akan memungkinkan perangkat dihentikan atau dihapus. Dalam hal ini, driver Anda tidak perlu memanggil WdfDeviceSetStaticStopRemove .

Driver harus mencocokkan setiap panggilan ke WdfDeviceSetStaticStopRemove dengan Stoppable diatur ke FALSE dengan panggilan ke WdfDeviceSetStaticStopRemove dengan Stoppable diatur ke TRUE.

Memanggil WdfDeviceSetStaticStopRemove dengan Stoppable diatur ke FALSE tidak mencegah kerangka kerja memberi tahu driver jika perangkat dihapus secara tiba-tiba (dihapus dari kejutan).

Untuk informasi selengkapnya tentang cara mencegah sistem operasi menghentikan perangkat, lihat Menangani Permintaan untuk Menghentikan Perangkat.

Contoh

Contoh kode berikut menginformasikan kerangka kerja bahwa perangkat yang ditentukan tidak dapat dihentikan dan dihapus.

WdfDeviceSetStaticStopRemove(
                             device,
                             FALSE
                             );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)