BdaMethodCreateTopology, fonction (bdasup.h)

Article
05/23/2024

La fonction BdaMethodCreateTopology crée une topologie de modèle entre deux broches d’un filtre.

Syntaxe

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

Paramètres

[in] pIrp

Pointe vers l’IRP pour la demande de création de topologie. Le minidriver BDA reçoit cet IRP avec la demande KSMETHOD_BDA_CREATE_TOPOLOGY .

[in] pKSMethod

Pointe vers une structure KSMETHOD qui décrit la méthode et le type de requête d’une demande de méthode.

[optional] pvIgnored

Pointe vers une mémoire tampon qui est ignorée.

Valeur retournée

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaMethodCreateTopology pour créer la topologie de modèle entre deux broches de filtre après que le minidriver a reçu une demande KSMETHOD_BDA_CREATE_TOPOLOGY de la méthode KSMETHODSETID_BdaDeviceConfiguration définie par le fournisseur réseau. La plupart des minidrivers BDA peuvent définir des tables de répartition et d’automatisation des filtres afin que ces minidrivers distribuent directement la fonction BdaMethodCreateTopology . Certains mini-disques BDA doivent intercepter cette requête à l’aide d’une méthode interne (KStrMethodHandler) au lieu de la distribuer directement. Ces minidrivers doivent obtenir un pointeur vers le filtre BDA à partir de l’IRP passé avant d’appeler BdaMethodCreateTopology afin qu’ils puissent utiliser le filtre pour suivre les broches associées. Ces minidrivers peuvent ensuite envoyer des instructions au matériel lors de la connexion de types de broches particuliers. Pour plus d’informations, consultez Définition de tables Automation et Configuration d’un filtre BDA .

Si un minidriver BDA doit créer la topologie de modèle entre deux broches de filtre sans dépendre du fournisseur réseau, le minidriver BDA doit appeler la fonction BdaCreateTopology .