Função BdaPropertyTemplateConnections (bdasup.h)

Artigo
02/22/2024

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 da 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 KSTOPOLOGY_CONNECTION que descrevem as conexões 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 BdaPropertyTemplateConnections para recuperar a lista de conexões de modelo depois que o minidriver recebe uma solicitação KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 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 expedim a função BdaPropertyTemplateConnections 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.

O minidriver BDA forneceu uma lista de conexões com a 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 chamadas de função BdaCreateFilterFactory e BdaInitFilter . Essa matriz é uma representação de todas as conexões possíveis entre os 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.