共用方式為

PCMETHOD_ITEM結構 （portcls.h）

  • 發行項

PCMETHOD_ITEM 結構描述篩選、釘選或節點所支援的方法。

語法

typedef struct {
  const GUID          *Set;
  ULONG               Id;
  ULONG               Flags;
  PCPFNMETHOD_HANDLER Handler;
} PCMETHOD_ITEM, *PPCMETHOD_ITEM;

成員

Set

指定方法集。 這個成員是 GUID 的指標，可唯一識別方法集。

Id

指定方法識別碼。 這個成員會識別方法集中的方法專案。 如果方法集包含 n 項目，則有效方法標識碼的範圍為 0 到 n-1 的整數。

Flags

指定方法所使用之參數傳遞和記憶體存取的類型。 此成員可以設定為下表中一或多個旗標位的位 OR。

旗標位 意義
PCMETHOD_ITEM_FLAG_MODIFY 方法會從 參數緩衝區讀取和寫入。
PCMETHOD_ITEM_FLAG_NONE 方法不會使用參數緩衝區。
PCMETHOD_ITEM_FLAG_READ 方法會從參數緩衝區讀取。
PCMETHOD_ITEM_FLAG_SOURCE 方法會先探查並鎖定記憶體頁面，再嘗試存取記憶體。
PCMETHOD_ITEM_FLAG_WRITE 方法會寫入參數緩衝區。

Handler

方法處理程式例程的指標。 此成員是類型為 PCPFNMETHOD_HANDLER 的函式指標，其定義如下：

  typedef NTSTATUS (*PCPFNMETHOD_HANDLER)
  (
      IN PPCMETHOD_REQUEST  MethodRequest
  );

呼叫 Handler 例程時，呼叫端會傳入單一呼叫參數，這是類型 PCMETHOD_REQUEST結構的指標。

言論

WDM 音訊子系統目前不支援篩選實例或針腳實例上的方法。 這項限制也排除了節點上方法的支援。

PCAUTOMATION_TABLE 結構包含PCMETHOD_ITEM結構數位的指標。

要求

要求 價值
標頭 portcls.h （包括 Portcls.h）

另請參閱

PCMETHOD_REQUEST