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

Статья
02/07/2025

Функция KsPinGetLeadingEdgeStreamPointer получает указатель потока переднего края для очереди, связанной с заданным закреплением.

Синтаксис

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Параметры

[in] Pin

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

[in] State

Этот параметр указывает, как получить указатель потока переднего края. Может быть одним из следующих вариантов:

KSSTREAM_POINTER_STATE_UNLOCKED

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

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

KSSTREAM_POINTER_STATE_LOCKED

Получение и блокировка указателя потока переднего края. Если кадр данных не связан с указателем потока, возвращается NULL. Если возвращается указатель, отличный отnull, он является заблокированным указателем потока и связан с ним кадром данных. Кадры, связанные с заблокированным указателем потока, не могут быть отменены.

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

KsPinGetLeadingEdgeStreamPointer возвращает указатель на структуру KSSTREAM_POINTER или NULL. Возвращаемое значение NULL может возникнуть, так как нет очереди, связанной с закреплением, указывая, что пин-код не использует стандартный механизм транспорта. Кроме того, возвращаемое значение NULL может произойти, так как попытка заблокировать передний край завершилась ошибкой, указывая на отсутствие кадра данных, связанного с передним краем.

Замечания

Фильтры, реализующие обработкиPin-Centric, часто вызывают KsPinGetLeadingEdgeStreamPointer.

Требования

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