KsCacheMedium 関数 (ks.h)

KsCacheMedium 関数を使用すると、Mediums を使用して接続を定義するピンのグラフ作成パフォーマンスが向上します。

構文

KSDDKAPI NTSTATUS KsCacheMedium(
  [in] PUNICODE_STRING SymbolicLink,
  [in] PKSPIN_MEDIUM   Medium,
  [in] ULONG           PinDirection
);

[in] SymbolicLink

デバイスインターフェイスを開くために使用されるシンボリックリンク。

[in] Medium

キャッシュするメディアを指します。

[in] PinDirection

Pin の方向を格納します。 1 は出力、0 は入力です。

キャッシュ操作が成功した場合、KsCacheMedium はSTATUS_SUCCESSを返します。成功していない場合は失敗します。

KsCacheMedium は、次の場合にレジストリキーを作成することで、グラフ構築のパフォーマンスを向上させます。

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

これにより、TvTuner やその他の複雑なグラフで接続されたフィルターを迅速に検索できます。 GUID は接続の Medium を識別し、DWORD はデバイスインスタンスを示します。値の名前はドライバーのシンボリックリンクで、ActualValue はピンの方向です。