EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX funzione di callback (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

La funzione di callback di un driver EvtDeviceUsageNotificationEx determina se un dispositivo può supportare un tipo di file speciale.

Sintassi

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] NotificationType

Valore WDF_SPECIAL_FILE_TYPEtipizzato che identifica il tipo di file speciale archiviato dal sistema nel dispositivo specificato.

[in] IsInNotificationPath

Valore booleano che, se TRUE, indica che il sistema ha iniziato a usare il file speciale e, se FALSE, indica che il sistema ha terminato di usare il file speciale.

Valore restituito

Se il driver determina che il dispositivo può supportare il file speciale, la funzione di callback EvtDeviceUsageNotificationEx deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(stato) è uguale TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS( stato) è uguale a FALSE.

Osservazioni

Se il driver deve fornire una gestione specifica del driver di file speciali, è necessario fornire un EvtDeviceUsageNotificationEx o un EvtDeviceUsageNotification funzione di callback degli eventi. Non fornire entrambe le funzioni di callback.

Per registrare un EvtDeviceUsageNotificationEx funzione di callback, un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.

Se il driver EvtDeviceUsageNotificationEx funzione di callback restituisce uno stato di errore, il framework propaga l'errore ad altri stack a cui potrebbe essere stata notificata in precedenza.

Per altre informazioni sui file speciali, vedere Supporto di file speciali.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.11
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

Condividi tramite