BdaMethodCreatePin - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// bdasup.h

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

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-bdasup-bdamethodcreatepin)

Description

The BdaMethodCreatePin function creates a pin factory.

Parameters

pIrp [in]

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.

pKSMethod [in]

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

pulPinFactoryID [out, optional]

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.

See also

BdaCreatePin

BdaMethodDeletePin

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_PIN_FACTORY

KStrMethodHandler