EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX Rückruffunktion (wdfdevice.h)

Artikel
03/05/2024

[Gilt für KMDF und UMDF]

Die EvtDeviceUsageNotificationEx-Ereignisrückruffunktion eines Treibers bestimmt, ob ein Gerät einen speziellen Dateityp unterstützen kann.

Syntax

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] NotificationType

Ein WDF_SPECIAL_FILE_TYPE typisierter Wert, der den Typ der speziellen Datei angibt, die das System auf dem angegebenen Gerät speichert.

[in] IsInNotificationPath

Ein boolescher Wert, der bei TRUE angibt, dass das System mit der Verwendung der speziellen Datei begonnen hat, und, wenn FALSE, angibt, dass das System die Verwendung der speziellen Datei abgeschlossen hat.

Rückgabewert

Wenn der Treiber feststellt, dass das Gerät die spezielle Datei unterstützen kann, muss die Rückruffunktion EvtDeviceUsageNotificationEx STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) true entspricht. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) false entspricht.

Hinweise

Wenn Ihr Treiber eine treiberspezifische Verarbeitung spezieller Dateien bereitstellen muss, müssen Sie entweder eine EvtDeviceUsageNotificationEx - oder eine Rückruffunktion für das EvtDeviceUsageNotification-Ereignis bereitstellen. Stellen Sie keine beiden Rückruffunktionen bereit.

Um eine EvtDeviceUsageNotificationEx-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacks aufrufen.

Wenn die EvtDeviceUsageNotificationEx-Rückruffunktion des Treibers einen Fehler status zurückgibt, gibt das Framework Fehler an andere Stapel weiter, die möglicherweise zuvor benachrichtigt wurden.

Weitere Informationen zu speziellen Dateien finden Sie unter Unterstützen von Spezialdateien.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.11
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
IRQL	PASSIVE_LEVEL

Freigeben über