Функция KsPinGetLeadingEdgeStreamPointer (ks.h)
Функция 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 может возникать из-за неудачной попытки заблокировать передний край, что указывает на отсутствие кадра данных, связанного с передним краем.
Комментарии
Фильтры, реализующие обработку, ориентированную на пин-код , часто вызывают KsPinGetLeadingEdgeStreamPointer.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
См. также раздел
KsPinGetTrailingEdgeStreamPointer