次の方法で共有

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 コールバック関数は、NT_SUCCESS(状態) が TRUE 等しいSTATUS_SUCCESSまたは別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE 等しい状態値を返す必要があります。

備考

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

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

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

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

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.11
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL