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

Статья
02/07/2025

KsPinGetAvailableByteCount выводит количество входных данных впереди переднего края и количество байтов выходного буфера впереди переднего края, как для очереди указанного абонентом пин-кода.

Синтаксис

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

Параметры

[in] Pin

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

[out, optional] InputDataBytes

Указатель на значение LONG, в котором подпрограмма возвращает количество входных данных байт впереди переднего края. Вызывающий объект задает значение NULL, если это значение не запрашивается.

[out, optional] OutputBufferBytes

Указатель на значение LONG, в котором подпрограмма возвращает количество байтов выходных буферов впереди переднего края. Вызывающий объект задает значение NULL, если это значение не запрашивается.

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

Возвращает STATUS_SUCCESS, если запрошенные счетчики были извлечены. Состояние неудачного возврата указывает, что пин-код не имеет связанной очереди.

Замечания

Неуместные пинки должны использовать InputDataBytes для входных контактов и OutputBufferBytes для выходных контактов.

Результаты этого вызова не гарантируют безопасности, если обработка мьютекса не проводится во время вызова, или вызывающий объект приватно синхронизирован перед вызовом подпрограммы. Чтобы выполнить частную синхронизацию, убедитесь, что пин-код не переходит от получения к остановке во время выполнения подпрограммы. См. раздел Обработка мьютекса в AVStream.

Кроме того, обратите внимание, что преобразование на месте может предоставлять количество входных и выходных данных.

В Windows XP и DirectX 8.0 число InputDataBytes недопустимо, если только кадры, полученные фильтром, не являются полными.

Дополнительные сведения см. в ведущих и конечных указателей потоков пограничных потоков.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX.
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib