BdaPropertyGetControllingPinId, fonction (bdasup.h)
La fonction BdaPropertyGetControllingPinId récupère l’identificateur d’une broche sur laquelle contrôler les propriétés, méthodes et événements d’un nœud spécifique.
Syntaxe
NTSTATUS BdaPropertyGetControllingPinId(
[in] PIRP Irp,
[in] PKSP_BDA_NODE_PIN Property,
[out, optional] PULONG pulControllingPinId
);
Paramètres
[in] Irp
Pointe vers l’IRP de la demande pour récupérer la broche de contrôle d’un nœud. Le minidriver BDA reçoit cet IRP avec la demande de KSPROPERTY_BDA_CONTROLLING_PIN_ID.
[in] Property
Pointe vers une structure KSP_BDA_NODE_PIN qui décrit la propriété et le type de requête de la requête de propriété pour récupérer la broche de contrôle d’un nœud.
[out, optional] pulControllingPinId
Pointe vers une variable qui reçoit l’identificateur de la broche de contrôle pour un nœud.
Valeur de retour
Retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Un minidriver BDA appelle la fonction BdaPropertyGetControllingPinId pour récupérer l’identificateur de la broche de contrôle d’un nœud une fois que le minidriver reçoit une requête KSPROPERTY_BDA_CONTROLLING_PIN_ID de la propriété KSPROPSETID_BdaTopology 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 BdaPropertyGetControllingPinId, 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |