Função BdaPropertyNodeDescriptors (bdasup.h)

A função BdaPropertyNodeDescriptors recupera uma lista de nós em uma topologia de modelo.

Sintaxe

NTSTATUS BdaPropertyNodeDescriptors(
  [in]            PIRP               pIrp,
  [in]            PKSPROPERTY        pKSProperty,
  [out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);

Parâmetros

[in] pIrp

Aponta para o IRP da solicitação para recuperar a lista de nós. O minidriver BDA recebe esse IRP com a solicitação KSPROPERTY_BDA_NODE_DESCRIPTORS .

[in] pKSProperty

Aponta para uma estrutura KSPROPERTY que descreve a propriedade e o tipo de solicitação da solicitação de propriedade.

[out, optional] pNodeDescriptorProperty

Aponta para uma matriz que recebe a lista de GUIDs para os nós em uma topologia de modelo.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaPropertyNodeDescriptors para recuperar a lista de nós depois que o minidriver recebe uma solicitação KSPROPERTY_BDA_NODE_DESCRIPTORS da propriedade KSPROPSETID_BdaTopology definida do provedor de rede. A maioria dos minidrivers BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers desempaquem a função BdaPropertyNodeDescriptors diretamente, sem interceptar essa solicitação usando um manipulador de get interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e Determinando a topologia do dispositivo BDA para obter mais informações.

Para obter uma lista de nós BDA que estão disponíveis para criar em uma topologia de modelo, consulte GUIDs de categoria de nó do BDA.

Requisitos

Confira também

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology