IPreFetchOffset::SetPreFetchOffset 方法 (portcls.h)

方法 SetPreFetchOffset 设置预提取偏移量,即在 DirectSound 输出流中将写入游标与播放游标分开的数据字节数。

语法

void SetPreFetchOffset(
  [in] ULONG PreFetchOffset
);

参数

[in] PreFetchOffset

指定预提取偏移大小(以字节为单位)。

返回值

备注

WavePci 微型端口驱动程序调用 SetPreFetchOffset 方法以指定硬件加速 DirectSound 输出流的预提取偏移量。

预提取偏移量是将写入光标与音频设备硬件缓冲区中的播放光标分开的数据字节数:

  • 写入光标指定 DirectSound 应用程序可以安全地写入下一个声音示例的缓冲区位置。
  • 播放光标指定音频设备当前正在播放的声音样本的缓冲区位置。
有关写入游标和播放游标的详细信息,请参阅 KSAUDIO_POSITION

有关使用 SetPreFetchOffset 来控制 DirectSound 流的预提取偏移量的信息,请参阅 预提取偏移量。

要求

要求
目标平台 通用
标头 portcls.h (包括 Portcls.h)
IRQL 任何级别

另请参阅

IMiniportWavePciStream::GetPosition

IPortWavePciStream::GetMapping

IPreFetchOffset

KSAUDIO_POSITION

KSPROPERTY_AUDIO_POSITION