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

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

Синтаксис

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 возвращает сведения о примерах, представленных в выходных данных системы. Это два разных фрагмента информации.

Требования

См. также

IMiniportWaveRTOutputStream