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

  • [アーティクル]

[KMDF にのみ適用]

バス ドライバーの EvtDeviceResourceRequirementsQuery イベント コールバック関数は、デバイスの必要なハードウェア リソースを表すリソース要件リストを作成します。

構文

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

パラメーター

[in] Device

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

[in] IoResourceRequirementsList

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

戻り値

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

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

注釈

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

フレームワークは、バス ドライバーの EvtDeviceResourceRequirementsQuery コールバック関数を呼び出して、デバイスの リソース要件リスト を取得します。

ドライバーは、指定された resource-requirements-list オブジェクトに、デバイスが適切に動作できるようにするハードウェア リソースの論理構成を設定する必要があります。

リソース要件リストを作成するために、ドライバーは、論理構成にリソース記述子を追加する フレームワーク resource-range-list オブジェクト メソッドと、リソース要件リストに論理構成を追加するフレームワーク resource-requirements-list オブジェクト メソッドを呼び出します。

ハードウェア リソースとリソース要件リストの作成の詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。

ドライバーが Windows 7 より前のオペレーティング システムバージョンで実行されている場合、バス ドライバーは EvtDeviceResourceRequirementsQuery を使用して、子を列挙する前に子デバイスに デバイス プロパティを設定 できます。

Windows 7 以降でデバイス プロパティを設定するために、バス ドライバーは、IRP_MN_DEVICE_ENUMERATEDの前処理ルーチンを提供できます。

要件

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

こちらもご覧ください

EvtDeviceResourcesQuery