KsTopologyPropertyHandler function (ks.h)

The KsTopologyPropertyHandler function performs standard handling of the static members of the KSPROPSETID_Topology Property Set. The function uses the KSTOPOLOGY structure, which describes the set of information that is returned by this property set.

Syntax

KSDDKAPI NTSTATUS KsTopologyPropertyHandler(
  [in]      PIRP             Irp,
  [in]      PKSPROPERTY      Property,
  [in, out] PVOID            Data,
  [in]      const KSTOPOLOGY *Topology
);

Parameters

[in] Irp

Specifies the IRP handling the property request.

[in] Property

Specifies the specific property being queried.

[in, out] Data

Specifies the topology property-specific data.

[in] Topology

Points to a KSTOPOLOGY structure containing the topology information.

Return value

The KsTopologyPropertyHandler function returns STATUS_SUCCESS if successful, or it returns an error specific to the property being handled. The function always fills in the IO_STATUS_BLOCK.Information field of the PIRP.IoStatus element within the IRP. It does not set the IO_STATUS_BLOCK.Status field, nor does it complete the IRP.

Requirements