wdfchildlist.h ヘッダー

[アーティクル]
08/08/2023

このヘッダーは wdf によって使用されます。詳細については、次を参照してください。

Windows Driver Framework

wdfchildlist.h には、次のプログラミングインターフェイスが含まれています。

関数


WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT関数は、WDF_CHILD_ADDRESS_DESCRIPTION_HEADER構造体を初期化します。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT関数は、WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER構造体を初期化します。
WDF_CHILD_LIST_CONFIG_INIT WDF_CHILD_LIST_CONFIG_INIT関数は、WDF_CHILD_LIST_CONFIG構造体を初期化します。
WDF_CHILD_LIST_ITERATOR_INIT WDF_CHILD_LIST_ITERATOR_INIT関数は、WDF_CHILD_LIST_ITERATOR構造体を初期化します。
WDF_CHILD_RETRIEVE_INFO_INIT WDF_CHILD_RETRIEVE_INFO_INIT関数は、WDF_CHILD_RETRIEVE_INFO構造体を初期化します。
WdfChildListAddOrUpdateChildDescriptionAsPresent WdfChildListAddOrUpdateChildDescriptionAsPresent メソッドは、子の一覧に新しい子の説明を追加するか、既存の子の説明を更新します。
WdfChildListBeginIteration WdfChildListBeginIteration メソッドは、指定された子リストから項目を取得するためのフレームワークを準備します。
WdfChildListBeginScan WdfChildListBeginScan メソッドは、ドライバーがリスト内の情報を更新できるように、指定された子デバイスの一覧を準備します。
WdfChildListCreate WdfChildListCreate メソッドは、指定された親デバイスの子リストを作成します。
WdfChildListEndIteration WdfChildListEndIteration メソッドは、指定した子リストに対する変更を処理します。
WdfChildListEndScan WdfChildListEndScan メソッドは、指定した子リストに対する変更を処理します。
WdfChildListGetDevice WdfChildListGetDevice メソッドは、指定された子リストの親デバイスを表すフレームワークデバイスオブジェクトへのハンドルを返します。
WdfChildListRequestChildEject WdfChildListRequestChildEject メソッドは、指定されたデバイスがドッキングステーションから取り出されようとしていることをフレームワークに通知します。
WdfChildListRetrieveAddressDescription WdfChildListRetrieveAddressDescription メソッドは、指定した識別の説明を持つ子デバイスを検索し、デバイスのアドレスの説明を取得します。
WdfChildListRetrieveNextDevice WdfChildListRetrieveNextDevice メソッドは、指定した子リストを走査し、指定した条件に一致する次の子デバイスを取得します。
WdfChildListRetrievePdo WdfChildListRetrievePdo メソッドは、子リスト内の指定された子の説明に関連付けられているフレームワークデバイスオブジェクトへのハンドルを返します。
WdfChildListUpdateAllChildDescriptionsAsPresent WdfChildListUpdateAllChildDescriptionsAsPresent メソッドは、指定された子リスト内のすべての子デバイスが接続され、使用可能であることをフレームワークに通知します。
WdfChildListUpdateChildDescriptionAsMissing WdfChildListUpdateChildDescriptionAsMissing メソッドは、指定された子デバイスが現在取り外されているか、使用できないことをフレームワークに通知します。

コールバック関数


EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP ドライバーの EvtChildListAddressDescriptionCleanup イベントコールバック関数は、ドライバーの EvtChildListAddressDescriptionDuplicate コールバック関数が割り当てたアドレス記述のメモリ割り当てを解放します。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY ドライバーの EvtChildListAddressDescriptionCopy イベントコールバック関数は、指定した場所から別の場所に子アドレスの説明をコピーします。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE ドライバーの EvtChildListAddressDescriptionDuplicate イベントコールバック関数は、子アドレスの説明を複製します。
EVT_WDF_CHILD_LIST_CREATE_DEVICE バスドライバーのEvtChildListCreateDevice イベントコールバック関数は、動的に列挙された新しいデバイスのフレームワークデバイスオブジェクトを作成します。
EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED ドライバーの EvtChildListDeviceReenumerated イベントコールバック関数を使用すると、ドライバーは指定したデバイスの再開を承認または取り消します。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP ドライバーの EvtChildListIdentificationDescriptionCleanup イベントコールバック関数は、ドライバーの EvtChildListIdentificationDescriptionDuplicate コールバック関数が割り当てた識別説明のメモリ割り当てを解放します。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE ドライバーの EvtChildListIdentificationDescriptionCompare イベントコールバック関数は、ある子識別の説明を別の子 ID の説明と比較します。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY ドライバーの EvtChildListIdentificationDescriptionCopy イベントコールバック関数は、指定した場所から別の場所に子 ID の説明をコピーします。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE ドライバーの EvtChildListIdentificationDescriptionDuplicate イベントコールバック関数は、子 ID の説明を複製します。
EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN ドライバーの EvtChildListScanForChildren イベントコールバック関数は、存在するすべての子デバイスを報告する必要があります。

構造


WDF_CHILD_ADDRESS_DESCRIPTION_HEADER WDF_CHILD_ADDRESS_DESCRIPTION_HEADER構造体は、すべてのアドレス記述構造体の最初のメンバーである必要があるヘッダー構造です。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER構造体は、すべての識別記述構造の最初のメンバーである必要があるヘッダー構造です。
WDF_CHILD_LIST_CONFIG WDF_CHILD_LIST_CONFIG構造体には、子デバイスの一覧の構成情報が含まれています。
WDF_CHILD_LIST_ITERATOR WDF_CHILD_LIST_ITERATOR構造体は、ドライバーが WdfChildListRetrieveNextDevice を呼び出したときにフレームワークが取得する子デバイスの種類を識別します。
WDF_CHILD_RETRIEVE_INFO WDF_CHILD_RETRIEVE_INFO構造体には、WdfChildListRetrieveNextDevice または WdfChildListRetrievePdo を呼び出すことによって取得される子デバイスに関する情報が含まれています。

列挙


WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS列挙は、フレームワークがドライバーのWDF_CHILD_RETRIEVE_INFO構造体に格納するデバイスの状態値を定義します。
WDF_RETRIEVE_CHILD_FLAGS WDF_RETRIEVE_CHILD_FLAGS列挙は、WdfChildListBeginIteration を呼び出す前にドライバーが設定できるフラグを定義します。