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 minidrivers 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 minidrivers 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
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | bdasup.h (include Bdasup.h) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |