Funzione BdaMethodCreateTopology (bdasup.h)

Articolo
05/23/2024

La funzione BdaMethodCreateTopology crea una topologia modello tra due pin di un filtro.

Sintassi

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

Parametri

[in] pIrp

Punta all'IRP per la richiesta di creazione della topologia. Il minidriver BDA riceve questo IRP con la richiesta di KSMETHOD_BDA_CREATE_TOPOLOGY .

[in] pKSMethod

Punta a una struttura KSMETHOD che descrive il metodo e il tipo di richiesta di una richiesta di metodo.

[optional] pvIgnored

Punta a un buffer ignorato.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

Un minidriver BDA chiama la funzione BdaMethodCreateTopology per creare la topologia del modello tra due pin di filtro dopo che il minidriver riceve una richiesta KSMETHOD_BDA_CREATE_TOPOLOGY del metodo KSMETHODSETID_BdaDeviceConfiguration impostato dal provider di rete. La maggior parte dei minidriver BDA può definire tabelle di invio e automazione dei filtri in modo che tali minidriver inviino direttamente la funzione BdaMethodCreateTopology . Alcuni minidriver BDA devono intercettare questa richiesta, usando un metodo interno (KStrMethodHandler), anziché inviarlo direttamente. Questi minidriver devono ottenere un puntatore al filtro BDA dall'IRP passato prima di chiamare BdaMethodCreateTopology in modo che possano usare il filtro per tenere traccia dei pin associati. Questi minidriver possono quindi inviare istruzioni all'hardware quando si connettono tipi di pin specifici. Per altre informazioni, vedere Definizione di tabelle di automazione e configurazione di un filtro BDA .

Se un minidriver BDA deve creare la topologia del modello tra due pin di filtro senza basarsi sul provider di rete, il minidriver BDA deve chiamare la funzione BdaCreateTopology .