KSEVENT_PINCAPS_FORMATCHANGE

發行項
06/15/2023

事件 KSEVENT_PINCAPS_FORMATCHANGE 會向音訊堆疊指出音訊裝置的音訊資料格式已變更。

使用量摘要表格

目標	事件描述元類型	事件數值型別
Pin	KSEVENT	KSEVENTDATA

事件數值型別 (作業資料) 是 KSEVENTDATA 結構，指定要用於此事件的通知方法。

備註

當音訊埠驅動程式為其迷你埠驅動程式呼叫 EventHandler 常式時，它會傳遞 PCEVENT_REQUEST 結構。這個結構包含 PCEVENT_ITEM 結構的指標，用來描述篩選、釘選或節點所支援的事件。

例如，支援 KSEVENT_PINCAPS_FORMATCHANGE 事件的驅動程式必須填入 PCEVENT_ITEM 結構，如下所示：

static PCEVENT_ITEM FormatChangePinEvent[] = {
  {
    &KSEVENTSETID_PinCapsChange,
    KSEVENT_PINCAPS_FORMATCHANGE,
    KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
    MyEventHandler
  }
};

在上述程式碼範例中，MyEventHandler 自訂事件處理常式必須監視 KSEVENT_PINCAPS_FORMATCHANGE 事件，並在觸發KSEVENT_PINCAPS_FORMATCHANGE時向 Portcls 註冊它。迷你埠驅動程式必須呼叫 IPortEvents：：AddEventToEventList 方法來註冊事件。

若要取得迷你埠驅動程式所支援之針腳、節點、連線和屬性的描述，埠驅動程式會呼叫 IMiniport：：GetDescription 方法。這個方法呼叫會傳回指向自動化資料表 (PCAUTOMATION_TABLE) 的PCFILTER_DESCRIPTOR結構。 PCAUTOMATION_TABLE結構具有Events成員。這個成員指向與迷你埠驅動程式所支援之篩選相關聯的事件陣列。因此，您必須將 Events 成員設定為指向包含事件 之PCEVENT_ITEM 結構 KSEVENT_PINCAPS_FORMATCHANGE 的事件陣列。

當迷你埠驅動程式偵測到動態格式變更時，它必須呼叫 IPortEvents：：GenerateEventList 方法來發出事件訊號 KSEVENT_PINCAPS_FORMATCHANGE 。