EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX função de retorno de chamada (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtDeviceUsageNotificationEx de um driver determina se um dispositivo pode dar suporte a um tipo de arquivo especial.

Sintaxe

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

Um identificador para um objeto de dispositivo de estrutura.

[in] NotificationType

Um valor de tipo WDF_SPECIAL_FILE_TYPE que identifica o tipo de arquivo especial que o sistema está armazenando no dispositivo especificado.

[in] IsInNotificationPath

Um valor booliano que, se VERDADEIRO, indica que o sistema começou a usar o arquivo especial e, se FALSE, indica que o sistema terminou de usar o arquivo especial.

Retornar valor

Se o driver determinar que o dispositivo pode dar suporte ao arquivo especial, a função de retorno de chamada EvtDeviceUsageNotificationEx deve retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

Comentários

Se o driver precisar fornecer tratamento específico do driver de arquivos especiais, você deverá fornecer uma função de retorno de chamada de evento EvtDeviceUsageNotificationEx ou EvtDeviceUsageNotification . Não forneça ambas as funções de retorno de chamada.

Para registrar uma função de retorno de chamada EvtDeviceUsageNotificationEx , um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.

Se a função de retorno de chamada EvtDeviceUsageNotificationEx do driver retornar um status de falha, a estrutura propagará a falha para outras pilhas que ela pode ter notificado anteriormente.

Para obter mais informações sobre arquivos especiais, consulte Suporte a arquivos especiais.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.11
Versão mínima do UMDF	2,0
Cabeçalho	wdfdevice.h (inclua Wdf.h)
IRQL	PASSIVE_LEVEL