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 値を返す必要があります。

このコールバック関数の戻り値の詳細については、「Reporting Device Failures」を参照してください。

注釈

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

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

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

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

必要条件

要件	価値
ターゲット プラットフォーム の	普遍
最小 KMDF バージョン	1.0
ヘッダー	wdfpdo.h (Wdf.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

EvtDeviceResourceRequirementsQuery の