Função BdaMethodCreatePin (bdasup.h)

Artigo
02/22/2024

A função BdaMethodCreatePin cria uma fábrica de pinos.

Sintaxe

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

Parâmetros

[in] pIrp

Aponta para o IRP para a solicitação para criar uma fábrica de pinos. O minidriver BDA recebe esse IRP com a solicitação KSMETHOD_BDA_CREATE_PIN_FACTORY .

[in] pKSMethod

Aponta para uma estrutura KSMETHOD que descreve o método e o tipo de solicitação de uma solicitação de método.

[out, optional] pulPinFactoryID

Aponta para uma variável que recebe o identificador da fábrica de pinos.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaMethodCreatePin para criar uma fábrica de pinos depois que o minidriver recebe uma solicitação KSMETHOD_BDA_CREATE_PIN_FACTORY do método KSMETHODSETID_BdaDeviceConfiguration definido do provedor de rede. A maioria dos minidrivers BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem a função BdaMethodCreatePin diretamente, sem interceptar essa solicitação usando um método interno (KStrMethodHandler). Consulte Definindo tabelas de automação e configurando um filtro BDA para obter mais informações.

Se um minidriver BDA precisar criar um pin sem depender do provedor de rede, o minidriver BDA deverá chamar a função BdaCreatePin .