WdfChildListBeginScan メソッド

The WdfChildListBeginScan method prepares a specified list of child devices so the driver can update the information in the list.

構文

VOID WdfChildListBeginScan(
  [in]  WDFCHILDLIST ChildList
);

パラメーター

ChildList [in]

A handle to a framework child list object.

戻り値

None.

A system bug check occurs if the driver supplies an invalid object handle.

解説

The WdfChildListBeginScan method marks all of the child devices in the list as missing.

After calling WdfChildListBeginScan, the driver can call WdfChildListAddOrUpdateChildDescriptionAsPresent repeatedly, or call WdfChildListUpdateAllChildDescriptionsAsPresent, to report all of the child devices that are currently attached to the parent device.

After the driver has finished updating the child list, it must call WdfChildListEndScan. This call delivers the updated child list to the Plug and Play (PnP) manager. Subsequently, the framework will call the driver's EvtChildListCreateDevice callback function for each device that the driver reported.

For more information about child lists, see Dynamic Enumeration.

For a code example that uses WdfChildListBeginScan, see WdfChildListAddOrUpdateChildDescriptionAsPresent.

要件

バージョン

Available in version 1.0 and later versions of KMDF.

ヘッダー

Wdfchildlist.h (includeWdf.h)

ライブラリ

Wdf<MajorVersionNumber>000.sys (see Framework Library Versions.)

IRQL

<= DISPATCH_LEVEL

参照

WdfChildListAddOrUpdateChildDescriptionAsPresent
WdfChildListBeginIteration
WdfChildListEndScan
WdfChildListUpdateAllChildDescriptionsAsPresent

 

 

コミュニティの追加

追加
表示:
© 2015 Microsoft