BdaCreatePin function (bdasup.h)

The BdaCreatePin function creates a new pin in the specified filter.

Syntax

NTSTATUS BdaCreatePin(
  [in]            PKSFILTER pKSFilter,
  [in]            ULONG     ulPinType,
  [out, optional] PULONG    pulPinId
);

Parameters

[in] pKSFilter

Points to the filter in which to create a pin.

[in] ulPinType

Specifies the type of pin to create. The BDA minidriver must define a list of pin types for each filter that it supports.

[out, optional] pulPinId

Points to a variable that receives the identifier for the created pin.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaMethodCreatePin function when the network provider dynamically creates a pin using the KSMETHOD_BDA_CREATE_PIN_FACTORY request of the KSMETHODSETID_BdaDeviceConfiguration method set. If a BDA minidriver must create a pin without relying on the network provider, the BDA minidriver should call the BdaCreatePin function directly.

.

Requirements

See also

BdaDeletePin

BdaMethodCreatePin

KSFILTER

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_PIN_FACTORY