KSPROPERTY_RTAUDIO_GETREADPACKET

KSPROPERTY_RTAUDIO_GETREADPACKET會傳回所擷取音訊封包的相關資訊。

使用量摘要表格

Get	集合	目標	屬性描述元類型	屬性值類型
是	否	Pin	KSPROPERTY	KSRTAUDIO_GETREADPACKET_INFO

屬性描述元 (實例資料) 是 KSPROPERTY 結構。 傳送要求之前，用戶端會載入結構，其中包含指出封包編號、封包長度和其他資訊的值。

屬性值是類型 KSRTAUDIO_GETREADPACKET_INFO的變數。

傳回值

KSPROPERTY_RTAUDIO_GETREADPACKET屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的失敗狀態碼。

STATUS_DEVICE_NOT_READY - 如果沒有任何新資料可用，驅動程式會傳回此錯誤。

備註

從 WaveRT 緩衝區讀取擷取的音訊資料之前，OS 會呼叫此常式以取得可用資料的相關資訊。

封包編號會識別資料流程內的封包。 當資料流程處於KSSTATE_STOP時，這會重設為零。 數位會隨著每個擷取的緩衝區前進。 從封包編號中，OS 可以衍生 WaveRT 緩衝區內的封包位置，也可以衍生封包相對於資料流程開頭的資料流程位置。

封包大小是 WaveRT 緩衝區大小除以傳遞至 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION的NotificationCount。 OS 可以隨時呼叫此常式。 在正常作業中，OS 會在驅動程式設定緩衝區通知事件之後，或在先前的呼叫傳回 MoreData 時傳回 true 之後，呼叫此常式。 當 OS 呼叫此常式時，驅動程式可能會假設 OS 已完成讀取所有先前的封包。 如果硬體已擷取足夠的資料，驅動程式可能會立即將下一個完整封包高載至 WaveRT 緩衝區，並再次設定緩衝區事件。 在擷取溢位 (當 OS 未快速讀取資料時，) 音訊驅動程式可能會卸載或覆寫某些音訊資料。 音訊驅動程式會先卸載或覆寫最舊的資料，即使 OS 可能尚未讀取資料，音訊驅動程式仍可繼續前進其內部封包計數器。

規格需求

版本	Windows 10及更新版本的 Windows 作業系統中提供。
標頭	Ksmedia.h

另請參閱

KSPROPERTY_RTAUDIO_SETWRITEPACKET

UsePositionLock