Функция KsPinRegisterFrameReturnCallback (ks.h)
Функция 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 |