Funzione WdfDeviceSetBusInformationForChildren (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfDeviceSetBusInformationForChildren imposta informazioni su un bus supportato da un driver del bus. Queste informazioni sono disponibili per i dispositivi figlio del bus.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] BusInformation

Puntatore a una struttura PNP_BUS_INFORMATION allocata dal chiamante che descrive il bus.

Valore restituito

Nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

I dispositivi figlio possono ottenere le informazioni fornite WdfDeviceSetBusInformationForChildren chiamando WdfFdoInitQueryProperty o WdfDeviceQueryProperty.

Esempi

L'esempio di codice seguente inizializza una struttura di PNP_BUS_INFORMATION e quindi chiama WdfDeviceSetBusInformationForChildren.

PNP_BUS_INFORMATION  busInfo;

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

WdfDeviceSetBusInformationForChildren(
                                      device,
                                      &busInfo
                                      );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

PNP_BUS_INFORMATION

Condividi tramite