EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX funzione di callback (wdfdevice.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtDeviceUsageNotificationEx di un driver 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_TYPE tipizzato 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 completato l'uso del 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 a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE.

Commenti

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

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

Se la funzione di callback EvtDeviceUsageNotificationEx del driver restituisce uno stato di errore, il framework propaga l'errore ad altri stack che potrebbero ricevere una notifica in precedenza.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.11
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)
IRQL	PASSIVE_LEVEL

Condividi tramite