Função BdaMethodCreateTopology (bdasup.h)

Artigo
02/26/2024

A função BdaMethodCreateTopology cria uma topologia de modelo entre dois pinos de um filtro.

Sintaxe

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

Parâmetros

[in] pIrp

Aponta para o IRP para a solicitação para criar topologia. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_CREATE_TOPOLOGY .

[in] pKSMethod

Aponta para uma estrutura KSMETHOD que descreve o método e o tipo de solicitação de uma solicitação de método.

[optional] pvIgnored

Aponta para um buffer ignorado.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaMethodCreateTopology para criar a topologia de modelo entre dois pinos de filtro depois que o minidriver recebe uma solicitação KSMETHOD_BDA_CREATE_TOPOLOGY do método KSMETHODSETID_BdaDeviceConfiguration definido 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 BdaMethodCreateTopology diretamente. Alguns minidrivers BDA devem interceptar essa solicitação, usando um método interno (KStrMethodHandler), em vez de expedir diretamente. Esses minidrivers devem obter um ponteiro para o filtro BDA do IRP passado antes de chamar BdaMethodCreateTopology para que possam usar o filtro para controlar os pinos associados. Esses minidrivers podem enviar instruções para o hardware ao conectar tipos de pino específicos. Consulte Definindo tabelas de automação e configurando um filtro BDA para obter mais informações.

Se um minidriver BDA precisar criar a topologia de modelo entre dois pinos de filtro sem depender do provedor de rede, o minidriver BDA deverá chamar a função BdaCreateTopology .