BdaMethodCreateTopology function (bdasup.h)

The BdaMethodCreateTopology function creates a template topology between two pins of a filter.

Syntax

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

Parameters

[in] pIrp

Points to the IRP for the request to create topology. The BDA minidriver receives this IRP with the KSMETHOD_BDA_CREATE_TOPOLOGY request.

[in] pKSMethod

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

[optional] pvIgnored

Points to a buffer that is ignored.

Return value

Returns STATUS_SUCCESS or an appropriate error code.

Remarks

A BDA minidriver calls the BdaMethodCreateTopology function to create the template topology between two filter pins after the minidriver receives a KSMETHOD_BDA_CREATE_TOPOLOGY 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 BdaMethodCreateTopology function directly. Some BDA minidrivers must intercept this request, using an internal method (KStrMethodHandler), rather than dispatch it directly. These mindrivers must obtain a pointer to the BDA filter from the passed IRP before calling BdaMethodCreateTopology so that they can use the filter to keep track of associated pins. These mindrivers can then send instructions to the hardware when connecting particular pin types. See Defining Automation Tables and Configuring a BDA Filter for more information.

If a BDA minidriver must create the template topology between two filter pins without relying on the network provider, the BDA minidriver should call the BdaCreateTopology function.

Requirements

See also

BdaCreateTopology

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_TOPOLOGY

KStrMethodHandler