WdfDeviceSetBusInformationForChildren-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfDeviceSetBusInformationForChildren Methode legt Informationen zu einem Bus fest, den ein Bustreiber unterstützt. Diese Informationen sind für die untergeordneten Geräte des Busses verfügbar.

Syntax

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] BusInformation

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

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Untergeordnete Geräte können die Informationen abrufen, die WdfDeviceSetBusInformationForChildren bereitgestellt werden, indem sie WdfFdoInitQueryProperty oder WdfDeviceQueryPropertyaufrufen.

Beispiele

Im folgenden Codebeispiel wird eine PNP_BUS_INFORMATION Struktur initialisiert und anschließend WdfDeviceSetBusInformationForChildrenaufgerufen.

PNP_BUS_INFORMATION  busInfo;

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

WdfDeviceSetBusInformationForChildren(
                                      device,
                                      &busInfo
                                      );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

PNP_BUS_INFORMATION

Freigeben über