共用方式為


PFNKSSTREAMPOINTER 回呼函式 (ks.h)

當取消與複製數據流指標相關聯的 IRP 時,AVStream 會呼叫 minidriver 的 AVStrMiniCancelCallback 例程。 此例程是選擇性的。

語法

PFNKSSTREAMPOINTER Pfnksstreampointer;

void Pfnksstreampointer(
  [in] PKSSTREAM_POINTER StreamPointer
)
{...}

參數

[in] StreamPointer

與已取消之 IRP 相關聯的複製 KSSTREAM_POINTER 指標。 StreamPointer 是由 KsStreamPointerClone 的呼叫所建立。

傳回值

備註

minidriver 會在 KsStreamPointerCloneCancelCallback 參數中指定此例程的位址。

AVStrMiniCancelCallback中,minidriver應該將所有複製指標的參考設定為 NULL

此外,minidriver 應該移除與複製指標相關的任何內容資訊,並通知硬體取消。

最後,minidriver 必須呼叫 KsStreamPointerDelete 來刪除複製品及其相關聯的內容。 如果 minidriver 未刪除複製品,IRP 會保留參考計數且未完成,可能會導致相關的應用程式損毀。

AVStrMiniCancelCallback 會呼叫並保留佇列的微調鎖定,因此DISPATCH_LEVEL。 因此,回呼例程無法執行佇列操作或呼叫取得 mutex 的函式。

規格需求

需求
最低支援的用戶端 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。
目標平台 桌面
標頭 ks.h (包含 Ks.h)

另請參閱

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete