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

Статья
02/29/2024

Функция 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 может возникать из-за неудачной попытки заблокировать передний край, что указывает на отсутствие кадра данных, связанного с передним краем.

Требования

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