WdfDeviceSetBusInformationForChildren-Funktion (wdfdevice.h)
[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) |