IMiniportMidiStream::SetState 方法 (portcls.h)
方法 SetState
将流的传输状态设置为新的状态值。
语法
NTSTATUS SetState(
[in] KSSTATE State
);
参数
[in] State
指定要将流设置为的新状态。 此参数是 KSSTATE 枚举值。 有关更多信息,请参见下面的“备注”部分。
返回值
SetState
如果调用成功,则返回STATUS_SUCCESS。 否则,该方法将返回相应的错误代码。
注解
对于音频筛选器图,四个 KSSTATE 枚举值解释如下:
-
KSSTATE_RUN
当前音频筛选器图中的数据传输正在运行并正常运行。
-
KSSTATE_ACQUIRE
这是一种过渡状态,可帮助管理KSSTATE_RUN与KSSTATE_STOP之间的转换。
-
KSSTATE_PAUSE
这是一种过渡状态,可帮助管理KSSTATE_RUN与KSSTATE_STOP之间的转换。
-
KSSTATE_STOP
数据传输在当前音频筛选器图中已停止。
转换始终按以下两个序列之一进行:
- STOP -> ACQUIRE -> PAUSE -> RUN
- RUN -> PAUSE -> ACQUIRE -> STOP
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | portcls.h (包括 Portcls.h) |
IRQL | PASSIVE_LEVEL |