Функция KsPinRegisterFrameReturnCallback (ks.h)

Статья
03/01/2024

Функция KsPinRegisterFrameReturnCallback регистрирует обратный вызов возврата кадра с помощью AVStream для заданного закрепления.

Синтаксис

void KsPinRegisterFrameReturnCallback(
  [in] PKSPIN              Pin,
  [in] PFNKSPINFRAMERETURN FrameReturn
);

Параметры

[in] Pin

Указатель на структуру AVStream KSPIN , которую необходимо поместить в режим внедрения путем регистрации обратного вызова возврата кадра.

[in] FrameReturn

Этот параметр предоставляет адрес подпрограммы AVStrMiniFrameReturn , предоставляемой мини-driver.

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

None

Remarks

Если закрепление зарегистрировало обратный вызов возврата кадра перед переходом с KSSTATE_STOP на KSSTATE_ACQUIRE, закрепление переводится в режим внедрения. Это означает, что закрепление не будет получать буферы и заполнять их, а вручную внедрять кадры данных в цепь с помощью KsPinSubmitFrame или KsPinSubmitFrameMdl. Когда кадр данных завершает свое перемещение по цепи и возвращается к контакту, на котором он был отправлен, AVStream перезапускает его, вызывая AVStrMiniFrameReturn.

Мини-накопители, вызывающие эту функцию, непосредственно отвечают за внедрение кадров в цепь; они не получают буферы для заполнения и не взаимодействуют с очередью напрямую, как и большинство мини-накопителей. Также обратите внимание, что обратный вызов возврата кадра должен быть зарегистрирован до создания раздела канала ядра. Раздел канала ядра создается при переходе контакта в KSSTATE_ACQUIRE. Дополнительные сведения см. в разделе Внедрение кадра.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)
Библиотека	Ks.lib
IRQL	PASSIVE_LEVEL

См. также раздел

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl

Share via