共用方式為


PFNKSPININITIALIZEALLOCATOR 回呼函式 (ks.h)

AVStream minidriver 的 AVStrMiniInitializeAllocator 例程會初始化與針腳相關聯的配置器。

語法

PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;

NTSTATUS Pfnkspininitializeallocator(
  [in]  PKSPIN Pin,
  [in]  PKSALLOCATOR_FRAMING AllocatorFraming,
  [out] PVOID *Context
)
{...}

參數

[in] Pin

KSPIN 結構的指標,描述配置器要與其關聯的針腳。

[in] AllocatorFraming

描述配置器應使用框架需求的 KSALLOCATOR_FRAMING 結構的指標。

[out] Context

配置器的內容指標,該配置器會當做參數傳遞至這個結構的其他例程。 例如,驅動程式可以儲存針腳或配置器框架結構,以供其他回呼例程稍後參考。 請注意,KSALLOCATOR_DISPATCH 的其他例程至少必須有參考 Pin的間接方式。 (例如,AVStrMiniAllocate 必須能夠存取 PinAllocatorFraming 資訊,而 Context 是唯一傳遞 AVStream 的參數。

傳回值

AVStrMiniInitializeAllocator 應該傳回STATUS_SUCCESS或嘗試建立配置器的錯誤碼。

言論

minidriver 會在 InitializeAllocator 中指定此例程的位址,KSALLOCATOR_DISPATCH 結構的成員。 minidriver 會將這個結構傳遞至 KSPIN_DISPATCH中的類別驅動程式。

請注意,內核模式配置器無法配置最終可能到達使用者模式的畫面格。

AVStream 會呼叫 AVStrMiniInitializeAllocator,以初始化指定的配置器。 此例程的處理程式應該準備處理記憶體配置和釋放要求。

如需詳細資訊,請參閱 KS 設定器

要求

要求 價值
最低支援的用戶端 Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺 桌面
標頭 ks.h (包括 Ks.h)

另請參閱

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN

KSPIN_DISPATCH