BdaPropertyNodeDescriptors, fonction (bdasup.h)
La fonction BdaPropertyNodeDescriptors récupère une liste de nœuds dans une topologie de modèle.
Syntaxe
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
Paramètres
[in] pIrp
Pointe vers l’IRP de la demande pour récupérer la liste des nœuds. Le minidriver BDA reçoit cet IRP avec la demande de KSPROPERTY_BDA_NODE_DESCRIPTORS.
[in] pKSProperty
Pointe vers une structure KSPROPERTY qui décrit la propriété et le type de requête de la requête de propriété.
[out, optional] pNodeDescriptorProperty
Pointe vers un tableau qui reçoit la liste des GUID pour les nœuds d’une topologie de modèle.
Valeur de retour
Retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Un minidriver BDA appelle la fonction BdaPropertyNodeDescriptors pour récupérer la liste des nœuds après que le minidriver reçoit une requête KSPROPERTY_BDA_NODE_DESCRIPTORS de la propriété KSPROPSETID_BdaTopology définie à partir du 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 les BdaPropertyNodeDescriptors fonction, sans intercepter cette requête à l’aide d’un gestionnaire get-handler interne (KStrGetPropertyHandler). Pour plus d’informations, consultez Définition des tables Automation et détermination de la topologie des appareils BDA.
Pour obtenir la liste des nœuds BDA disponibles pour créer dans une topologie de modèle, consultez GUID de catégorie de nœud BDA.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible sur Microsoft Windows XP et les systèmes d’exploitation ultérieurs. Cette routine est disponible sur la plateforme Windows 2000 uniquement si Microsoft DirectX 9.0 et versions ultérieures sont installées sur cette plateforme. |
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |