BdaMethodCreatePin function (bdasup.h)

Article
06/29/2022

The BdaMethodCreatePin function creates a pin factory.

Syntax

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

Parameters

[in] pIrp

Points to the IRP for the request to create a pin factory. The BDA minidriver receives this IRP with the KSMETHOD_BDA_CREATE_PIN_FACTORY request.

[in] pKSMethod

Points to a KSMETHOD structure that describes the method and request type of a method request.

[out, optional] pulPinFactoryID

Points to a variable that receives the identifier of the pin factory.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaMethodCreatePin function to create a pin factory after the minidriver receives a KSMETHOD_BDA_CREATE_PIN_FACTORY request of the KSMETHODSETID_BdaDeviceConfiguration method set from the network provider. Most BDA minidrivers can define dispatch and filter-automation tables so that those minidrivers dispatch the BdaMethodCreatePin function directly, without intercepting this request using an internal method (KStrMethodHandler). See Defining Automation Tables and Configuring a BDA Filter for more information.

If a BDA minidriver must create a pin without relying on the network provider, the BDA minidriver should call the BdaCreatePin function.

Requirements

Requirement	Value
Target Platform	Desktop
Header	bdasup.h (include Bdasup.h)
Library	Bdasup.lib
IRQL	PASSIVE_LEVEL