Função BdaPropertyTemplateConnections (bdasup.h)

Artigo
02/06/2025

A função BdaPropertyTemplateConnections recupera uma lista de conexões que descrevem como tipos de pino e tipos de nó são conectados em uma topologia de modelo.

Sintaxe

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Parâmetros

[in] pIrp

Aponta para o IRP para a solicitação para recuperar a lista de conexões. O minidriver BDA recebe esse IRP com a solicitação KSPROPERTY_BDA_TEMPLATE_CONNECTIONS.

[in] pKSProperty

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

[out, optional] pConnectionProperty

Aponta para uma matriz que recebe a lista de estruturas de KSTOPOLOGY_CONNECTION que descrevem as conexões em uma topologia de modelo.

Valor de retorno

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Observações

Um minidriver BDA chama a função BdaPropertyTemplateConnections para recuperar a lista de conexões de modelo depois que o minidriver recebe uma solicitação KSPROPERTY_BDA_TEMPLATE_CONNECTIONS do conjunto de propriedades KSPROPSETID_BdaTopology do provedor de rede. A maioria dos minidrivers BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem a função BdaPropertyTemplateConnections diretamente, sem interceptar essa solicitação usando um get-handler interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e determinando de topologia de dispositivo BDA para obter mais informações.

O minidriver BDA forneceu uma lista de conexões à biblioteca de suporte do BDA em uma matriz de estruturas KSTOPOLOGY_CONNECTION quando o minidriver BDA passou o modelo de filtro BDA (BDA_FILTER_TEMPLATE) em BdaCreateFilterFactory e BdaInitFilter chamadas de função. Essa matriz é uma representação de todas as conexões possíveis entre tipos de nó e pino que podem ser feitas dentro do filtro ou entre o filtro e os filtros adjacentes. A função BdaPropertyTemplateConnections retorna essa matriz.