Funzione BdaMethodCreatePin (bdasup.h)

La funzione BdaMethodCreatePin crea una pin factory.

Sintassi

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

[in] pIrp

Punta all'IRP per la richiesta di creare una factory di pin. Il minidriver BDA riceve l'IRP con la richiesta di KSMETHOD_BDA_CREATE_PIN_FACTORY .

[in] pKSMethod

Punta a una struttura KSMETHOD che descrive il metodo e il tipo di richiesta di una richiesta di metodo.

[out, optional] pulPinFactoryID

Punta a una variabile che riceve l'identificatore della fabbrica di pin.

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Un minidriver BDA chiama la funzione BdaMethodCreatePin per creare una pin factory dopo che il minidriver riceve una richiesta di KSMETHOD_BDA_CREATE_PIN_FACTORY del metodo KSMETHODSETID_BdaDeviceConfiguration impostato dal provider di rete. La maggior parte dei minidriver BDA può definire tabelle di invio e automazione filtro in modo che tali minidriver inviino direttamente la funzione BdaMethodCreatePin , senza intercettare questa richiesta usando un metodo interno (KStrMethodHandler). Per altre informazioni, vedere Definizione di tabelle di automazione e configurazione di un filtro BDA .

Se un minidriver BDA deve creare un pin senza basarsi sul provider di rete, il minidriver BDA deve chiamare la funzione BdaCreatePin .