EVT_WDF_DEVICE_RESOURCES_QUERY コールバック関数 (wdfpdo.h)

  • [アーティクル]

[KMDF にのみ適用]

バス ドライバーの EvtDeviceResourcesQuery イベント コールバック関数は、指定されたデバイスの ブート構成を表すリソース リストを作成します。

構文

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

パラメーター

[in] Device

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

[in] Resources

空のリソース リストを表すフレームワーク リソース リスト オブジェクトへのハンドル。

戻り値

ドライバーでエラーが発生しなかった場合は、(ブート構成リソースを指定しているかどうかに関係なく) STATUS_SUCCESSを返す必要があります。 ドライバーでエラーが発生した場合は、FALSE と評価NT_SUCCESS NTSTATUS 値を返す必要があります。

このコールバック関数の戻り値の詳細については、「 デバイスエラーの報告」を参照してください。

注釈

フレームワーク ベースのバス ドライバーは、 EvtDeviceResourcesQuery コールバック関数を提供できます。 このコールバック関数を登録するために、バス ドライバーは WdfPdoInitSetEventCallbacks を呼び出します。

フレームワークは、バス ドライバーの EvtDeviceResourcesQuery コールバック関数を呼び出して、デバイスのブート構成を指定する リソース リスト を取得します。

ドライバーは、指定されたリソース一覧オブジェクトに、デバイスのブート要件を表すハードウェア リソースを設定する必要があります。 PnP デバイスのドライバーは、システム BIOS からこの要件情報を取得します。

リソース リストを作成するために、ドライバーは、Resources パラメーターで表される resource-list オブジェクトにリソースを追加するフレームワーク resource-list オブジェクト メソッドを呼び出します。ハードウェア リソースとリソース リストの作成の詳細については、「Framework-Based ドライバーのハードウェア リソース」を参照してください。

要件

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

こちらもご覧ください

EvtDeviceResourceRequirementsQuery