WdfPdoInitSetEventCallbacks 関数 (wdfpdo.h)
[KMDF にのみ適用]
WdfPdoInitSetEventCallbacks メソッドは、バス ドライバーのイベント コールバック関数を登録します。
構文
void WdfPdoInitSetEventCallbacks(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_PDO_EVENT_CALLBACKS DispatchTable
);
パラメーター
[in] DeviceInit
WDFDEVICE_INIT構造体へのポインター。
[in] DispatchTable
呼び出し元によって割り当てられた WDF_PDO_EVENT_CALLBACKS 構造体へのポインター。
戻り値
なし
解説
バス ドライバーは 、WDF_PDO_EVENT_CALLBACKS 構造体を割り当て、ドライバーのイベント コールバック関数へのポインターを構造体に入力する必要があります。
ドライバーは、WdfDeviceCreate を呼び出す前に WdfPdoInitSetEventCallbacks を呼び出す必要があります。 WdfPdoInitSetEventCallbacks と WdfDeviceCreate の呼び出しの詳細については、「バス ドライバーでのデバイス オブジェクトの作成」を参照してください。
例
次のコード例では、 WDF_PDO_EVENT_CALLBACKS 構造体を初期化し、 WdfPdoInitSetEventCallbacks を呼び出します。
PWDFDEVICE_INIT pDeviceInit = NULL;
WDF_PDO_EVENT_CALLBACKS pdoCallbacks;
pDeviceInit = WdfPdoInitAllocate(Device);
WDF_PDO_EVENT_CALLBACKS_INIT(&pdoCallbacks);
pdoCallbacks.EvtDeviceResourceRequirementsQuery = Bus_Pdo_EvtDeviceResourceRequirementsQuery;
WdfPdoInitSetEventCallbacks(
pDeviceInit,
&pdoCallbacks
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfpdo.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |