Compartir a través de

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX función de devolución de llamada (wdfdevice.h)

  • Artículo

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos EvtDeviceUsageNotificationEx de un controlador determina si un dispositivo puede admitir un tipo de archivo especial.

Sintaxis

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

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

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] NotificationType

Valor WDF_SPECIAL_FILE_TYPE tipo que identifica el tipo de archivo especial que el sistema almacena en el dispositivo especificado.

[in] IsInNotificationPath

Valor booleano que, si es TRUE, indica que el sistema ha empezado a usar el archivo especial y, si es FALSE, indica que el sistema ha terminado de usar el archivo especial.

Valor devuelto

Si el controlador determina que el dispositivo puede admitir el archivo especial, la función de devolución de llamada EvtDeviceUsageNotificationEx debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Comentarios

Si el controlador debe proporcionar un control específico del controlador de archivos especiales, debe proporcionar una función de devolución de llamada de evento EvtDeviceUsageNotificationEx o EvtDeviceUsageNotification . No proporcione ambas funciones de devolución de llamada.

Para registrar una función de devolución de llamada EvtDeviceUsageNotificationEx , un controlador debe llamar a WdfDeviceInitSetPnpPowerEventCallbacks.

Si la función de devolución de llamada EvtDeviceUsageNotificationEx del controlador devuelve un estado de error, el marco propaga el error a otras pilas que puede haber notificado anteriormente.

Para obtener más información sobre los archivos especiales, vea Archivos especiales auxiliares.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.11
Versión mínima de UMDF 2.0
Encabezado wdfdevice.h (incluya Wdf.h)
IRQL PASSIVE_LEVEL