EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS コールバック関数 (wdffdo.h)
[KMDF にのみ適用]
ドライバーの EvtDeviceFilterAddResourceRequirements イベント コールバック関数は、システムがデバイスにリソースを割り当てる前に、一連のハードウェア リソース要件にリソースを追加できます。
ドライバーの EvtDeviceFilterRemoveResourceRequirements イベント コールバック関数は、システムがデバイスにリソースを割り当てる前に、一連のハードウェア リソース要件からリソースを削除できます。
構文
EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;
NTSTATUS EvtWdfDeviceFilterResourceRequirements(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
パラメーター
[in] Device
リソースが割り当てられるフレームワーク デバイス オブジェクトへのハンドル。
[in] IoResourceRequirementsList
デバイスのリソース要件リストを表す resource-requirements-list オブジェクトへのハンドル。
戻り値
ドライバーでエラーが発生しなかった場合は、STATUS_SUCCESSを返す必要があります。 それ以外の場合は、FALSE と評価NT_SUCCESS NTSTATUS 値を返す必要があります。
戻り値の詳細については、「 デバイスエラーの報告」を参照してください。
注釈
フレームワーク ベースの関数ドライバーは、 EvtDeviceFilterAddResourceRequirements および EvtDeviceFilterRemoveResourceRequirementsコールバック関数を提供できます。 これらのコールバック関数を登録するために、ドライバーは WdfFdoInitSetEventCallbacks を呼び出します。
フレームワークがドライバーの EvtDeviceFilterAddResourceRequirements コールバック関数を呼び出すと、ドライバーは論理構成にリソース記述子を追加でき、追加の論理構成を提供できます。 これらの追加された項目は、関数ドライバーがデバイスを動作させるために必要なリソースを表します。
ドライバーの EvtDeviceFilterAddResourceRequirements コールバック関数がデバイスのリソース要件リストに項目を追加し、PnP マネージャーがデバイスの要件リストにリソースを割り当てる場合、ドライバーの EvtDeviceRemoveAddedResources コールバック関数は、デバイスのリソース リストから追加されたリソースを削除する必要があります。
リソース要件リストに項目を追加または削除するために、ドライバーは フレームワーク resource-requirements-list オブジェクト メソッド とフレームワーク resource-range-list オブジェクト メソッドを呼び出します。これにより、 IoResourceRequirementsList パラメーターで表される resource-requirements-list オブジェクトが操作されます。
これらのコールバック関数の詳細については、「 リソース要件リストの変更」を参照してください。
ハードウェア リソースとリソース要件の一覧の詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。
割り込みリソース (プロセッサ アフィニティなど) の変更については、 WdfInterruptSetPolicy の「解説」セクションを参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdffdo.h (Wdf.h を含む) |
IRQL | PASSIVE_LEVEL |