BdaMethodCreateTopology - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// bdasup.h
NTSTATUS BdaMethodCreateTopology(
[in] PIRP pIrp,
[in] PKSMETHOD pKSMethod,
[optional] PVOID pvIgnored
);
View the official Windows Driver Kit DDI referenceNo description available.
The BdaMethodCreateTopology function creates a template topology between two pins of a filter.
pIrp [in]Points to the IRP for the request to create topology. The BDA minidriver receives this IRP with the KSMETHOD_BDA_CREATE_TOPOLOGY request.
pKSMethod [in]Points to a KSMETHOD structure that describes the method and request type of a method request.
pvIgnored [optional]Points to a buffer that is ignored.
Returns STATUS_SUCCESS or an appropriate error code.
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.
KSMETHODSETID_BdaDeviceConfiguration