Função WdfDeviceSetBusInformationForChildren (wdfdevice.h)

Artigo
07/02/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceSetBusInformationForChildren define informações sobre um ônibus compatível com um motorista de ônibus. Essas informações estão disponíveis para os dispositivos filho do ônibus.

Sintaxe

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

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] BusInformation

Um ponteiro para uma estrutura de PNP_BUS_INFORMATION alocada pelo chamador que descreve o barramento.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Os dispositivos filho podem obter as informações que WdfDeviceSetBusInformationForChildren chamando WdfFdoInitQueryProperty ou WdfDeviceQueryProperty.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de PNP_BUS_INFORMATION e chama WdfDeviceSetBusInformationForChildren.

PNP_BUS_INFORMATION  busInfo;

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

WdfDeviceSetBusInformationForChildren(
                                      device,
                                      &busInfo
                                      );

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

PNP_BUS_INFORMATION

Compartilhar via