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 |