nf-ks-kscachemedium.md

UID	title	description	old-location	tech.root	ms.date	keywords	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	f1_keywords	topic_type	api_type	api_location	api_name
NF:ks.KsCacheMedium	KsCacheMedium function (ks.h)	The KsCacheMedium function improves graph building performance of pins that use Mediums to define connectivity.	stream\kscachemedium.htm	stream	04/23/2018	KsCacheMedium function	KsCacheMedium, KsCacheMedium function [Streaming Media Devices], ks/KsCacheMedium, ksfunc_19ac113f-3eb8-4073-90b0-786cc82cdf37.xml, stream.kscachemedium	ks.h	Ks.h	Universal												Ks.lib			Windows		KsCacheMedium ks/KsCacheMedium	APIRef kbSyntax	LibDef	Ks.lib Ks.dll	KsCacheMedium

KsCacheMedium function

-description

The KsCacheMedium function improves graph building performance of pins that use Mediums to define connectivity.

-parameters

-param SymbolicLink [in]

The symbolic link used to open the device interface.

-param Medium [in]

Points to the medium to cache.

-param PinDirection [in]

Contains the direction of the Pin. 1 is output, 0 is input.

-returns

KsCacheMedium returns STATUS_SUCCESS if the caching operation is successful, failure if it is not.

-remarks

KsCacheMedium improves graph building performance by creating a registry key at:

\System\CurrentControlSet\Control\MediumCache\GUID\DWORD\DWORD

This enables fast lookup of connected filters in TvTuner and other complex graphs. Note that the GUID identifies the Medium of the connection, and that the DWORDs denote the device instance. The value name is the SymbolicLink for the driver, and ActualValue is the pin direction.turning.