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

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

Синтаксис

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

Параметры

[in] Pin

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

[in] FrameReturn

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

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

Никакой

Замечания

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

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

Требования

См. также

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl