KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET通知驅動程式 OS 已將有效的資料寫入 WaveRT 緩衝區。
使用量摘要表格
Get | 集合 | 目標 | 屬性描述元類型 | 屬性值類型 |
---|---|---|---|---|
否 | 是 | Pin | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
屬性描述元 (實例資料) 是 KSPROPERTY 結構。 傳送要求之前,用戶端會以包含封包編號、封包長度和其他資訊的值載入 結構。
屬性值是類型 KSRTAUDIO_SETWRITEPACKET_INFO的結構。
傳回值
KSPROPERTY_RTAUDIO_SETWRITEPACKET屬性要求會傳回STATUS_SUCCESS,表示它已順利完成。 否則,要求會傳回適當的失敗狀態碼。
備註
如果支援此 KSPROPERTY,驅動程式可以選擇性地使用提供的資訊來優化硬體傳輸。 例如,驅動程式可能會優化 DMA 傳輸,或程式硬體停止在指定封包結尾的傳輸,以防 OS 不會再次呼叫此常式,通知驅動程式另一個封包。 這可以減輕下溢的可聽見效果,例如引進可聽見的間距,而不是重複迴圈緩衝區。 不過,驅動程式仍然必須以實際率增加其內部封包計數器和訊號通知事件。
除了 OS 指定 KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM 旗標之外,封包大小是 WaveRT 緩衝區大小除以傳遞至 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION的 NotificationCount。
視硬體功能而定,如果指定 KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM 旗標,則驅動程式可能會無聲填滿一部分的 WaveRT 緩衝區,以在硬體傳輸超過 EOS 位置的資料時,于 EOS 封包之後填滿部分。
規格需求
版本 |
Windows 10及更新版本的 Windows 作業系統中提供。 |
標頭 |
Ksmedia.h |