IMFSinkWriter：:P laceMarker 方法 (mfreadwrite.h)
Places 指定數據流中的標記。
語法
HRESULT PlaceMarker(
[in] DWORD dwStreamIndex,
[in] LPVOID pvContext
);
參數
[in] dwStreamIndex
數據流以零起始的索引。
[in] pvContext
應用程式定義值的指標。 此參數的值會傳回給呼叫端之 IMFSinkWriterCallback：：OnMarker 回呼方法之 pvContext 參數中的呼叫端。 應用程式負責與此數據相關聯的任何記憶體配置。 此參數可以是 Null。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | Description |
|---|---|
|
此方法已成功。 |
|
要求無效。 |
備註
若要使用此方法，您必須在建立接收寫入器時提供異步回呼。 否則，方法會 傳回MF_E_INVALIDREQUEST。 如需詳細資訊，請參閱 MF_SINK_WRITER_ASYNC_CALLBACK。
標記提供在媒體接收取用數據流中所有樣本到特定時間點時通知的方法。 媒體接收在處理標記之前的所有樣本之前，都不會處理標記。 當媒體接收處理標記時，接收寫入器會呼叫應用程式的 OnMarker 方法。 叫用回呼時，您知道接收已取用該數據流的所有先前範例。
例如，若要變更格式中間流，請在格式變更的點呼叫 PlaceMarker 。 呼叫 OnMarker 時，安全地呼叫 IMFSinkWriter：：SetInputMediaType 來變更輸入類型， (假設媒體接收支持動態格式變更) 。
在內部，這個方法會在媒體接收上呼叫 IMFStreamSink：:P laceMarker 。
注意IMFSinkWriter：:P laceMarker 方法的 pvContext 參數不會傳遞至 IMFStreamSink：:P laceMarker 方法的 pvarContextValue 參數。 這兩個參數不直接相關。
如果已安裝適用於 Windows Vista 的平臺更新補充，則此介面可在 Windows Vista 上使用。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | mfreadwrite.h |