KsQuerySoftwareBusInterface function (swenum.h)

Article
02/22/2024

This function is intended for internal use only.

The KsQuerySoftwareBusInterface function creates a buffer from the paged pool and copies the reference string associated with the demand-load bus enumerator object's PDO into the buffer. It is the caller's responsibility to free the buffer using ExFreePool.

Syntax

KSDDKAPI NTSTATUS KsQuerySoftwareBusInterface(
  [in]  PDEVICE_OBJECT        PnpDeviceObject,
  [out] PBUS_INTERFACE_SWENUM BusInterface
);

Parameters

[in] PnpDeviceObject

Pointer to the demand-load bus enumerator's device object.

[out] BusInterface

Pointer to the demand-load bus enumerator's interface.

Return value

Returns STATUS_SUCCESS if the request is handled. Otherwise, it returns an appropriate error code.

Remarks

A minidriver can access this function through the QueryReferenceString member of the BUS_INTERFACE_SWENUM structure.

Requirements

Requirement	Value
Target Platform	Desktop
Header	swenum.h (include Swenum.h)