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

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtDeviceUsageNotificationEx do 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 WDF_SPECIAL_FILE_TYPEdigitado 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.

Valor de retorno

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

Observações

Se o driver precisar fornecer tratamento específico do driver de arquivos especiais, você deverá fornecer um EvtDeviceUsageNotificationEx ou uma função de retorno de chamada de evento 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 o driver EvtDeviceUsageNotificationEx função de retorno de chamada retornará um status de falha, a estrutura propagará falha para outras pilhas que ele pode ter notificado anteriormente.

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

Requisitos

Requisito	Valor
da 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

Partilhar via