EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX fungsi panggilan balik (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtDeviceUsageNotificationEx driver menentukan apakah perangkat dapat mendukung jenis file khusus.

Sintaks

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

NTSTATUS EvtWdfDeviceUsageNotificationEx(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] NotificationType

Nilai jenis WDF_SPECIAL_FILE_TYPE yang mengidentifikasi jenis file khusus yang disimpan sistem pada perangkat yang ditentukan.

[in] IsInNotificationPath

Nilai Boolean yang, jika TRUE, menunjukkan bahwa sistem telah mulai menggunakan file khusus dan, jika FALSE, menunjukkan bahwa sistem telah selesai menggunakan file khusus.

Nilai kembali

Jika driver menentukan bahwa perangkat dapat mendukung file khusus, fungsi panggilan balik EvtDeviceUsageNotificationEx harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(statusnya) sama dengan TRUE. Jika tidak, nilai status harus mengembalikan nilai yang NT_SUCCESS(statusnya) sama dengan FALSE.

Keterangan

Jika driver Anda harus menyediakan penanganan khusus driver file khusus, Anda harus menyediakan fungsi panggilan balik peristiwa EvtDeviceUsageNotificationEx atau EvtDeviceUsageNotification . Jangan sediakan kedua fungsi panggilan balik.

Untuk mendaftarkan fungsi panggilan balik EvtDeviceUsageNotificationEx , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.

Jika fungsi panggilan balik EvtDeviceUsageNotificationEx driver mengembalikan status kegagalan, kerangka kerja menyebarkan kegagalan ke tumpukan lain yang mungkin telah diberi tahu sebelumnya.

Untuk informasi selengkapnya tentang file khusus, lihat Mendukung File Khusus.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1.11
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
IRQL PASSIVE_LEVEL