WdfDeviceSetBusInformationForChildren function (wdfdevice.h)

[Applies to KMDF only]

The WdfDeviceSetBusInformationForChildren method sets information about a bus that a bus driver supports. This information is available to the bus's child devices.

Syntax

void WdfDeviceSetBusInformationForChildren(
  [in] WDFDEVICE            Device,
  [in] PPNP_BUS_INFORMATION BusInformation
);

Parameters

[in] Device

A handle to a framework device object.

[in] BusInformation

A pointer to a caller-allocated PNP_BUS_INFORMATION structure that describes the bus.

Return value

None

Remarks

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

Child devices can obtain the information that WdfDeviceSetBusInformationForChildren supplies by calling WdfFdoInitQueryProperty or WdfDeviceQueryProperty.

Examples

The following code example initializes a PNP_BUS_INFORMATION structure and then calls WdfDeviceSetBusInformationForChildren.

PNP_BUS_INFORMATION  busInfo;

busInfo.BusTypeGuid = GUID_DEVCLASS_TOASTER;
busInfo.LegacyBusType = PNPBus;
busInfo.BusNumber = 0;

WdfDeviceSetBusInformationForChildren(
                                      device,
                                      &busInfo
                                      );

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfdevice.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI compliance rules DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

See also

PNP_BUS_INFORMATION