EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES コールバック関数 (wdffdo.h)
[KMDF にのみ適用]
ドライバーの EvtDeviceRemoveAddedResources イベント コールバック関数は、ドライバーの EvtDeviceFilterAddResourceRequirements コールバック関数が追加したハードウェア リソースを削除します。
構文
EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;
NTSTATUS EvtWdfDeviceRemoveAddedResources(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST ResourcesRaw,
[in] WDFCMRESLIST ResourcesTranslated
)
{...}
パラメーター
[in] Device
リソースが割り当てられるフレームワーク デバイス オブジェクトへのハンドル。
[in] ResourcesRaw
PnP マネージャーがデバイスに割り当てた未加工のハードウェア リソースを識別するリソース リスト オブジェクトへのハンドル。
[in] ResourcesTranslated
PnP マネージャーがデバイスに割り当てた、変換されたハードウェア リソースを識別するリソース リスト オブジェクトへのハンドル。
戻り値
ドライバーでエラーが発生しなかった場合は、STATUS_SUCCESSを返す必要があります。 それ以外の場合は、FALSE と評価NT_SUCCESS NTSTATUS 値を返す必要があります。
戻り値の詳細については、「 デバイスエラーの報告」を参照してください。
注釈
フレームワーク ベースの関数ドライバーは、 EvtDeviceRemoveAddedResources コールバック関数を提供できます。 このコールバック関数を登録するために、ドライバーは WdfFdoInitSetEventCallbacks を呼び出します。
ドライバーが、デバイスのハードウェア要件リストにリソースを追加する EvtDeviceFilterAddResourceRequirements コールバック関数を提供する場合、ドライバーは EvtDeviceRemoveAddedResources コールバック関数も提供する必要があります。 EvtDeviceRemoveAddedResources コールバック関数は、PnP マネージャーがデバイスに割り当てたリソース リストを調べ、EvtDeviceFilterAddResourceRequirements コールバック関数が追加したリストからリソースを削除します。 ドライバーがリソースを削除する場合は、未加工のリソース リストと翻訳されたリソース リストの両方からリソースを削除する必要があります。
リソース リストとリソースの表示順序の詳細については、「 生および翻訳されたハードウェア リソース」を参照してください。
フレームワークは、デバイスのリソース 一覧をバス ドライバーに渡す直前に、ドライバーの EvtDeviceRemoveAddedResources コールバック関数を呼び出します。 このコールバック関数は、追加されたリソースを削除して、バス ドライバーがリソースの使用を試みないようにします。
EvtDeviceRemoveAddedResources コールバック関数の詳細については、「リソース 一覧の変更」を参照してください。
ハードウェア リソースの詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdffdo.h (Wdf.h を含む) |
| IRQL | PASSIVE_LEVEL |