BdaPropertyGetControllingPinId, fonction (bdasup.h)

Article
02/22/2024

La fonction BdaPropertyGetControllingPinId récupère l’identificateur d’une broche sur laquelle contrôler les propriétés, les méthodes et les é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 pour la demande de récupération de l’épingle de contrôle pour un nœud. Le minidriver BDA reçoit cette IRP avec la demande 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 demande de la demande de propriété pour récupérer la broche de contrôle pour 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 retournée

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 pour un nœud après que le minidriver a reçu une demande de KSPROPERTY_BDA_CONTROLLING_PIN_ID de la propriété KSPROPSETID_BdaTopology définie du fournisseur de réseau. La plupart des minidrivers BDA peuvent définir des tables dispatch et filter-automation afin que ces minidrivers distribuent la fonction BdaPropertyGetControllingPinId directement, sans intercepter cette requête à l’aide d’un get-handler interne (KStrGetPropertyHandler). Pour plus d’informations, consultez Définition de tables Automation et Détermination de la topologie d’appareil BDA .