KsStreamPointerClone 函式 （ks.h）
KsStreamPointerClone 函式會建立指定數據流指標的複本。
語法
KSDDKAPI NTSTATUS KsStreamPointerClone(
[in] PKSSTREAM_POINTER StreamPointer,
[in, optional] PFNKSSTREAMPOINTER CancelCallback,
[in] ULONG ContextSize,
[out] PKSSTREAM_POINTER *CloneStreamPointer
);
參數
[in] StreamPointer
KSSTREAM_POINTER 結構的指標，表示要複製的數據流指標。
[in, optional] CancelCallback
自選。 提供 AVStrMiniCancelCallback 例程之 minidriver 的指標。 如果取消與 CloneStreamPointer 相關聯的 IRP，AVStream 就會呼叫此例程。
[in] ContextSize
此參數指出產生的複製數據流指標應該具有多少個迷你驅動程序內容資訊。 如果不是零，則會在傳回的數據流指標之後立即配置要求的位元元組數目，而cloneStreamPointer 指向所配置記憶體的 Context 欄位。
[out] CloneStreamPointer
指向 KSSTREAM_POINTER 結構的指標。 複製作業成功完成時，CloneStreamPointer 包含複製數據流指標位址的指標。
傳回值
KsStreamPointerClone 會傳回STATUS_SUCCESS，指出複製作業正常完成，或是適當的錯誤碼。
言論
產生的複製最初是指與原始數據流指標相同的數據框架，且處於相同的狀態（鎖定或解除鎖定）。 加入參考數據框架的複製數據流指標會遞增該特定畫面的參考計數。 請注意，在參考計數降至零之前，不會完成有問題的框架，因此框架所屬的 IRP。
您可以使用這個呼叫的 ContextSize 參數，將配置呼叫降到最低。
另請參閱 串流指標。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ks.h （包括 Ks.h） |
| 連結庫 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |