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
選擇性。 minidriver 提供的 AVStrMiniCancelCallback 例程的指標。 如果取消了與 CloneStreamPointer 相關聯的 IRP，AVStream 就會呼叫此例程。
[in] ContextSize
此參數指出產生的複製數據流指標應該具有多少個迷你驅動程序內容資訊。 如果不是零，則會在傳回的數據流指標之後立即配置要求的位元組數目，而 CloneStreamPointer的內容欄位會指向配置的記憶體。
[out] CloneStreamPointer
KSSTREAM_POINTER 結構的指標。 複製作業成功完成時， CloneStreamPointer 會包含複製數據流指標位址的指標。
傳回值
KsStreamPointerClone 會傳回STATUS_SUCCESS，指出複製作業正常完成，或適當的錯誤碼。
備註
產生的複製一開始是指與原始數據流指標相同的數據框架，而且處於 (鎖定或解除鎖定) 的狀態。 加入參考數據框架的複製數據流指標會遞增該特定框架的參考計數。 請注意，在參考計數下降為零之前，不會完成有問題的框架，因此框架所屬的 IRP。
您可以使用此呼叫的 ContextSize 參數，將配置呼叫降到最低。
另請參閱 Stream指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |