KsGetObjectTypeFromIrp function (ks.h)

Article
02/22/2024

The KsGetObjectTypeFromIrp function returns the AVStream object type that is associated with a given IRP.

Syntax

KSDDKAPI KSOBJECTTYPE KsGetObjectTypeFromIrp(
  [in] PIRP Irp
);

Parameters

[in] Irp

A pointer to the IRP structure for which to find the associated AVStream object type.

Return value

KsGetObjectTypeFromIrp returns the type of AVStream object associated with the given IRP as a KSOBJECTTYPE enumeration. This is one of the following: KsObjectTypeDevice, KsObjectTypeFilterFactory, KsObjectTypeFilter, KsObjectTypePin.

Remarks

The KsGetObjectTypeFromIrp function does not check that the I/O request packet (IRP) is associated with a KS object. If it is not, this may result in a memory access error. Driver developers should consider using structured exception handling to catch a possible exception.

Requirements

Requirement	Value
Minimum supported client	Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform	Universal
Header	ks.h (include Ks.h)
Library	Ks.lib
IRQL	Any level