Edit

Share via

BdaMethodCreatePin function (bdasup.h)

  • Article

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

See also

BdaCreatePin

BdaMethodDeletePin

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_PIN_FACTORY

KStrMethodHandler