PFNKSSTREAMPOINTER 回呼函式 (ks.h)
當取消與複製數據流指標相關聯的 IRP 時,AVStream 會呼叫 minidriver 的 AVStrMiniCancelCallback 例程。 此例程是選擇性的。
語法
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
參數
[in] StreamPointer
與已取消之 IRP 相關聯的複製 KSSTREAM_POINTER 指標。 StreamPointer 是由 KsStreamPointerClone 的呼叫所建立。
傳回值
無
備註
minidriver 會在 KsStreamPointerClone 的 CancelCallback 參數中指定此例程的位址。
在 AVStrMiniCancelCallback中,minidriver應該將所有複製指標的參考設定為 NULL。
此外,minidriver 應該移除與複製指標相關的任何內容資訊,並通知硬體取消。
最後,minidriver 必須呼叫 KsStreamPointerDelete 來刪除複製品及其相關聯的內容。 如果 minidriver 未刪除複製品,IRP 會保留參考計數且未完成,可能會導致相關的應用程式損毀。
AVStrMiniCancelCallback 會呼叫並保留佇列的微調鎖定,因此DISPATCH_LEVEL。 因此,回呼例程無法執行佇列操作或呼叫取得 mutex 的函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
目標平台 | 桌面 |
標頭 | ks.h (包含 Ks.h) |