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 的函式。

規格需求

另請參閱

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete