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 の「解説」セクションを参照してください。

要件

こちらもご覧ください

EvtDeviceRemoveAddedResources