Функция 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

Содержит направление закрепления. 1 — это выходные данные, 0 — входные данные.

Возвращаемое значение

KsCacheMedium возвращает STATUS_SUCCESS, если операция кэширования выполнена успешно, а в противном случае — сбой.

Комментарии

KsCacheMedium повышает производительность построения графа за счет создания раздела реестра по адресу:

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

Это обеспечивает быстрый поиск подключенных фильтров в TvTuner и других сложных графах. Обратите внимание, что GUID идентифицирует среду подключения, а DWORD обозначает экземпляр устройства. Имя значения — SymbolicLink для драйвера, а ActualValue — направление закрепления.поворот.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib