EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX Rückruffunktion (wdfdevice.h)

Artikel
02/07/2025

[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 zu einem Framework-Geräteobjekt.

[in] NotificationType

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

[in] IsInNotificationPath

Ein boolescher Wert, der, wenn 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 EvtDeviceUsageNotificationEx- Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUEentspricht. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE-entspricht.

Bemerkungen

Wenn Ihr Treiber eine treiberspezifische Behandlung spezieller Dateien bereitstellen muss, müssen Sie entweder eine EvtDeviceUsageNotificationEx oder eine EvtDeviceUsageNotification Ereignisrückruffunktion bereitstellen. Stellen Sie nicht beide Rückruffunktionen bereit.

Um eine EvtDeviceUsageNotificationEx Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.

Wenn die EvtDeviceUsageNotificationEx- Rückruffunktion einen Fehlerstatus zurückgibt, gibt das Framework den Fehler an andere Stapel weiter, die er zuvor möglicherweise benachrichtigt hat.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.11
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
IRQL-	PASSIVE_LEVEL

Freigeben über