Метод IMiniportWaveRTOutputStream::GetOutputStreamPresentationPosition (portcls.h)

Статья
08/07/2023

Возвращает сведения о представлении потока.

Синтаксис

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

Параметры

[out] pPresentationPosition

pPresentationPosition возвращает KSAUDIO_PRESENTATION_POSITION структуру, представляющую последнюю позицию презентации в потоке аудиоданных. Дополнительные сведения см. в разделе IMiniportStreamAudioEngineNode::GetStreamPresentationPosition.

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

GetOutputStreamPresentationPosition возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае функция возвращает соответствующий код состояния ошибки.

ОС может периодически получать это свойство от драйвера, чтобы получать последние сведения о положении презентации от драйвера, чтобы разрешить верхним слоям синхронизировать видео или другие действия с аудиопотоком.

Значение, возвращаемое в элементе u64PositionInBlocks KSAUDIO_PRESENTATION_POSITION, должно соответствовать количеству пакетов, возвращенным GetPacketCount, и интерпретации драйвера номера пакета, переданного в SetWritePacket. Иными словами, первая выборка пакета 0 — это блок 0.

Это не означает, что GetPacketCount и GetOutputStreamPresentationPosition, если они вызываются одновременно, будут возвращать значения, ссылающиеся на один и тот же образец. GetPacketCount возвращает сведения о примерах, переданных из буфера WaveRT на оборудование, а GetOutputStreamPresentationPosition — сведения о примерах, представленных в выходных данных системы. Это два разных элемента информации.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 10 и более поздних версиях.
Целевая платформа	Windows
Header	portcls.h
IRQL	Пассивный уровень

См. также раздел

IMiniportWaveRTOutputStream