KsGetObjectTypeFromFileObject function (ks.h)

The KsGetObjectTypeFromFileObject function returns the AVStream object type that is associated with a given file object.

Syntax

KSDDKAPI KSOBJECTTYPE KsGetObjectTypeFromFileObject(
  [in] PFILE_OBJECT FileObject
);

Parameters

[in] FileObject

A pointer to the FILE_OBJECT structure for which to determine the associated AVStream object type.

Return value

KsGetObjectTypeFromFileObject returns the object type of the AVStream object associated with FileObject as a KSOBJECTTYPE enumeration. This can be one of the following: KsObjectTypeDevice, KsObjectTypeFilterFactory, KsObjectTypeFilter, or KsObjectTypePin.

Remarks

The KsGetObjectTypeFromFileObject function does not check that the file object 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

See also

KsGetFilterFromFileObject

KsGetObjectFromFileObject

KsGetPinFromFileObject

KsPinGetConnectedPinFileObject