WdfDeviceSetBusInformationForChildren function (wdfdevice.h)

Artikel
02/22/2024

[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)

Delen via