KsGetDevice function (ks.h)

Article
02/22/2024

The KsGetDevice function returns the AVStream device structure to which Object belongs.

Syntax

KSDDKAPI PKSDEVICE KsGetDevice(
  [in] PVOID Object
);

Parameters

[in] Object

The object to query for the device to which it belongs.

Return value

KsGetDevice returns a pointer to a KSDEVICE structure that is the AVStream device to which Object belongs.

Remarks

Object should be one of: PKSPIN, PKSFILTER, or PKSFILTERFACTORY. Callers must perform appropriate typecasting to PVOID.

Minidrivers typically do not call this function directly. There are a number of functions that perform inline calls to KsGetDevice and that perform typecasting automatically: KsFilterFactoryGetDevice, KsFilterGetDevice, and KsPinGetDevice.

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	PASSIVE_LEVEL