KsGateGetStateUnsafe 函式 （ks.h）

KsGateGetStateUnsafe 函式會以不安全的方式傳回指定閘道的狀態（開啟或關閉），不論同步處理 為何，。

語法

BOOLEAN KsGateGetStateUnsafe(
  [in] PKSGATE Gate
);

參數

[in] Gate

KSGATE 結構的指標，表示要傳回狀態的閘道。

傳回值

如果閘道已開啟，則此呼叫會傳回 true true，如果閘道已關閉，FALSE。

言論

由於 KsGateGetStateUnsafe 無法處理同步處理，因此，如果網關在呼叫時從某個狀態過渡到另一個狀態，可能會取得與閘道狀態不一致的結果。

請考慮閘道 A 的輸出作為閘道 B 輸入的情況。轉換至已關閉，導致 B 從開啟轉換為關閉。 如果另一個線程同時呼叫 KsGateGetStateUnsafe A 關閉與 B 關閉的時間，則例程仍會傳回 B 已開啟。

KsGateGetStateUnsafe 會傳回 Gate->Count 是否大於零。 函式不會使用任何聯結函式來執行此動作。 因此，呼叫會執行而不考慮同步處理。

要求

要求	價值
最低支援的用戶端	Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺	桌面
標頭	ks.h （包括 Ks.h）
IRQL	任何層級