WdfDeviceSetBusInformationForChildren-Funktion (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfDeviceSetBusInformationForChildren-Methode legt Informationen zu einem Bus fest, den ein Bustreiber unterstützt. Diese Informationen stehen den untergeordneten Geräten des Busses zur Verfügung.

Syntax

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] BusInformation

Ein Zeiger auf eine vom Aufrufer zugewiesene PNP_BUS_INFORMATION Struktur, die den Bus beschreibt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Untergeordnete Geräte können die Von WdfDeviceSetBusInformationForChildren bereitgestellten Informationen abrufen, indem sie WdfFdoInitQueryProperty oder WdfDeviceQueryProperty aufrufen.

Beispiele

Im folgenden Codebeispiel wird eine PNP_BUS_INFORMATION-Struktur initialisiert und dann WdfDeviceSetBusInformationForChildren aufgerufen.

PNP_BUS_INFORMATION  busInfo;

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

WdfDeviceSetBusInformationForChildren(
                                      device,
                                      &busInfo
                                      );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

PNP_BUS_INFORMATION