(dmusicks.h) IMXF：：SetState 方法

SetState 方法可用來設定 MIDI 轉換介面的狀態。

語法

NTSTATUS SetState(
  KSSTATE State
);

State

指定要設定篩選圖形的狀態。此參數是 KSSTATE 列舉值。如需詳細資訊，請參閱接下來的＜備註＞一節。

如果呼叫成功，這個方法會傳回NTSTATUS，其中包含STATUS_SUCCESS。否則，方法會傳回適當的錯誤碼。

針對音訊篩選圖形，四個 KSSTATE 列舉值會解譯如下：

值	State
KSSTATE_RUN	所有專案都正常執行並正常運作。在此狀態中，IMXF 介面將會處於作用中狀態，並如往常一樣傳遞訊息。
KSSTATE_ACQUIRE	這是一種轉換狀態，可協助管理KSSTATE_RUN與KSSTATE_STOP之間的轉換。在此狀態中，無法在篩選圖形中下游傳遞訊息。
KSSTATE_PAUSE	這是一種轉換狀態，可協助管理KSSTATE_RUN與KSSTATE_STOP之間的轉換。
KSSTATE_STOP	目前篩選圖表中所有專案都已停止。

迷你埠驅動程序的行為取決於篩選圖形的狀態。此行為與轉譯 (輸出) 不同，並擷取 (輸入) 。

在輸出端，如果目前狀態是KSSTATE_RUN以外的任何狀態，IMXF 介面應該會保留到數據上，而不會將它傳遞給硬體。如果目前的狀態是KSTATE_STOP，迷你埠驅動程序應該捨棄任何數據，方法是將該數據傳遞至配置器。

在輸入端，如果輸入數據流位於KSSTATE_RUN或KSSTATE_PAUSE，迷你埠驅動程式會從配置器取得訊息，並將其傳送至擷取接收。如果狀態KSSTATE_STOP或KSSTATE_ACQUIRE，且硬體嘗試產生數據，則應該會擲回該數據。

需求	值
標頭	dmusicks.h
IRQL	PASSIVE_LEVEL