Função BdaMethodCreateTopology (bdasup.h)

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 a 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.

Valor de retorno

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Observações

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 do BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem diretamente a função BdaMethodCreateTopology. 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 acompanhar os pinos associados. Esses minidrivers podem enviar instruções para o hardware ao conectar determinados tipos de pino. 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.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	bdasup.h (inclua Bdasup.h)
biblioteca	Bdasup.lib
IRQL	PASSIVE_LEVEL

Consulte também

BdaCreateTopology

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_TOPOLOGY

KStrMethodHandler