IMiniportMidiStream::SetFormat 方法 (portcls.h)

SetFormat 方法设置 MIDI 流的 KS 数据格式。

语法

NTSTATUS SetFormat(
  [in] PKSDATAFORMAT DataFormat
);

参数

[in] DataFormat

指定流的新格式。 此参数是指向 KSDATAFORMAT类型的结构的指针。

返回值

如果调用成功,SetFormat 返回STATUS_SUCCESS。 否则,该方法将返回适当的错误代码。

言论

SetFormat 方法实质上不执行任何作,因为 MIDI 流的数据格式不能更改为 MIDI 以外的任何内容。 为了完整性和正交性,提供了此方法与 IMiniportWaveCyclicIMiniportWavePci 接口中的 SetFormat 方法的正交性。 请参阅 Microsoft Windows 驱动程序工具包(WDK)中 fmsynth 示例音频驱动程序中此方法的简单实现。 可以将示例代码用作自己的实现的模板。

要求

要求 价值
目标平台 普遍
标头 portcls.h (包括 Portcls.h)
IRQL PASSIVE_LEVEL

另请参阅

IMiniportMidiStream

KSDATAFORMAT