EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX コールバック関数 (wdfdevice.h)

[KMDF と UMDF に適用]

ドライバーの EvtDeviceUsageNotificationEx イベント コールバック関数は、デバイスが特殊なファイルの種類をサポートできるかどうかを決定します。

構文

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

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

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] NotificationType

システムが指定したデバイスに格納している特殊なファイルの種類を識別する、 WDF_SPECIAL_FILE_TYPE型指定された値。

[in] IsInNotificationPath

ブール値 。 TRUE の場合は、システムが特殊なファイルの使用を開始したことを示し、 FALSE の場合は、システムが特別なファイルの使用を完了したことを示します。

戻り値

デバイスが特別なファイルをサポートできるとドライバーが判断した場合、EvtDeviceUsageNotificationEx コールバック関数は、STATUS_SUCCESSまたはNT_SUCCESS(status) が TRUE と等しい別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE状態値を返す必要があります。

注釈

ドライバーが特別なファイルのドライバー固有の処理を提供する必要がある場合は、 EvtDeviceUsageNotificationEx または EvtDeviceUsageNotification イベント コールバック関数を指定する必要があります。 両方のコールバック関数を指定しないでください。

EvtDeviceUsageNotificationEx コールバック関数を登録するには、ドライバーで WdfDeviceInitSetPnpPowerEventCallbacks を呼び出す必要があります。

ドライバーの EvtDeviceUsageNotificationEx コールバック関数がエラー状態を返した場合、フレームワークは、以前に通知した可能性のある他のスタックにエラーを伝達します。

特別なファイルの詳細については、「特別なファイルの サポート」を参照してください。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.11
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL