CImageAllocator.NotifyMediaType 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
方法 NotifyMediaType 會通知物件目前媒體類型。
語法
void NotifyMediaType(
CMediaType *pMediaType
);
參數
-
pMediaType
-
CMediaType物件的指標，或Null以清除媒體類型。
傳回值
這個方法不會傳回值。
備註
每當媒體類型變更時，擁有篩選應該呼叫這個方法。 一般而言，當針腳第一次連接時，以及動態格式變更之後，就會發生這種情況。 配置器會使用媒體類型來驗證建議的配置器屬性，以及建立媒體範例時。
CImageAllocator物件會將pMediaType指標儲存在m_pMediaType成員變數中。 因此，如果呼叫端需要釋放 CMediaType 物件，它應該再次呼叫這個方法，使用新的指標或 Null 值來更新配置器。 否則，配置器嘗試參考舊指標時可能會發生錯誤。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|