BdaMethodCreateTopology, fonction (bdasup.h)
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 de 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 requête de méthode.
[optional] pvIgnored
Pointe vers une mémoire tampon ignorée.
Valeur de retour
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 une fois que le minidriver reçoit une requête KSMETHOD_BDA_CREATE_TOPOLOGY de la méthode KSMETHODSETID_BdaDeviceConfiguration définie à partir du fournisseur de 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 minidrivers BDA doivent intercepter cette requête à l’aide d’une méthode interne (KStrMethodHandler), plutôt que 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 broche particuliers. Pour plus d’informations, consultez Définition des tables Automation et Configuration d’un de filtre BDA.
Si un minidriver BDA doit créer la topologie de modèle entre deux broches de filtre sans compter sur le fournisseur de réseau, le minidriver BDA doit appeler la fonction BdaCreateTopology.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |