Fonction BdaMethodCreatePin (bdasup.h)

Article
02/26/2024

La fonction BdaMethodCreatePin crée une fabrique de broches.

Syntaxe

NTSTATUS BdaMethodCreatePin(
  [in]            PIRP      pIrp,
  [in]            PKSMETHOD pKSMethod,
  [out, optional] PULONG    pulPinFactoryID
);

Paramètres

[in] pIrp

Pointe vers l’IRP pour la demande de création d’une fabrique de broches. Le minidriver BDA reçoit cette IRP avec la demande KSMETHOD_BDA_CREATE_PIN_FACTORY .

[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.

[out, optional] pulPinFactoryID

Pointe vers une variable qui reçoit l’identificateur de la fabrique de broches.

Valeur retournée

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaMethodCreatePin pour créer une fabrique de broches après que le minidriver a reçu une demande KSMETHOD_BDA_CREATE_PIN_FACTORY de la méthode KSMETHODSETID_BdaDeviceConfiguration définie par le fournisseur réseau. La plupart des minidrivers BDA peuvent définir des tables dispatch et filter-automation afin que ces minidrivers distribuent directement la fonction BdaMethodCreatePin , sans intercepter cette requête à l’aide d’une méthode interne (KStrMethodHandler). Pour plus d’informations, consultez Définition de tables Automation et Configuration d’un filtre BDA .

Si un minidriver BDA doit créer une broche sans dépendre du fournisseur réseau, le minidriver BDA doit appeler la fonction BdaCreatePin .