KSMETHOD 結構

發行項
02/07/2024

KSMETHOD 結構會指定方法集合內的單一核心串流方法。

KSEVENT、KSMETHOD 和 KSPROPERTY 結構是 KSIDENTIFIER 結構的別名。因此，其定義完全相同。

語法

struct KSMETHOD {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

成員

Set

指定識別核心串流方法集的 GUID。

For more information about method set GUIDs, see the Remarks section below.

Id

指定方法集的成員。

Flags

指定要求類型。另請參閱KSMETHOD_ITEM) KSMETHOD_TYPE_Xxx旗標。

要求可以包含下表所列值的組合。

值	方法要求的類型
KSMETHOD_TYPE_BASICSUPPORT	指示查詢迷你驅動程式，以判斷它是否支援方法集的指定方法。
KSMETHOD_TYPE_SEND	表示迷你驅動程式應該執行指定的方法。客戶端必須知道方法對指定參數的影響，亦即參數是讀取、寫入、寫入兩者或兩者皆非。迷你驅動程式會使用 KSMETHOD_ITEM 結構來指定方法對參數的影響。
KSMETHOD_TYPE_SETSUPPORT	指示查詢迷你驅動程式，以判斷它是否支援指定的方法集。
KSMETHOD_TYPE_TOPOLOGY	表示指定的方法的類型為 KSM_NODE，其中 NodeId 成員是拓撲節點的標識碼。請勿自行設定此旗標;相反地，或此清單中的其他旗標。

備註

Microsoft 提供數個系統定義的方法集 GUID。 Minidrivers 會在 Set 成員中指定其中一個 GUID。核心串流方法集合通常會以 KSMETHODSETID 前置詞開頭。核心串流方法集定義於 ks.h、 ksmedia.h、 bdamedia.h，以及其他頭檔。

如需核心串流事件的詳細資訊，請參閱 KS 屬性、事件和方法。

用戶端可以使用IOCTL_KS_METHOD要求以及 KSMETHOD 結構，在迷你驅動程序處理的核心串流物件上執行方法。如需詳細資訊，請參閱 KS 方法。