IMiniportWaveRTOutputStream：：GetOutputStreamPresentationPosition 方法 (portcls.h)

傳回數據流簡報資訊。

語法

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

參數

[out] pPresentationPosition

pPresentationPosition 會傳回 KSAUDIO_PRESENTATION_POSITION 結構，代表音訊數據流中最近的簡報位置。 如需詳細資訊，請參閱 IMiniportStreamAudioEngineNode：：GetStreamPresentationPosition。

傳回值

GetOutputStreamPresentationPosition 如果呼叫成功，則會傳回STATUS_SUCCESS。 否則，函式會傳回適當的錯誤狀態代碼。

備註

OS 可能會定期從驅動程式取得這個屬性，以從驅動程式擷取最近的簡報位置資訊，以允許上層同步處理視訊或其他活動與音訊數據流。

在 KSAUDIO_PRESENTATION_POSITION u64PositionInBlocks 成員中傳回的值應該與 GetPacketCount 所傳回的封包計數一致，以及驅動程式傳遞至 SetWritePacket 的封包編號解譯。 換句話說，封包0的第一個範例是區塊0。

這並不表示如果同時呼叫 GetPacketCount 和 GetOutputStreamPresentationPosition，則會傳回參考相同範例的值。 GetPacketCount 會傳回從 WaveRT 緩衝區傳輸至硬體之樣本的相關信息，而 GetOutputStreamPresentationPosition 則會傳回系統輸出中呈現之範例的相關信息。 這些是兩個不同的資訊片段。

規格需求

需求	值
最低支援的用戶端	可在 Windows 10 和更新版本中使用。
目標平台	Windows
標頭	portcls.h
IRQL	被動層級

另請參閱

IMiniportWaveRTOutputStream