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 必須能夠存取 Pin的 AllocatorFraming 資訊，而 Context 是 AVStream 將傳遞它的唯一參數。)

傳回值

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

備註

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

請注意，核心模式配置器無法配置最終可觸達使用者模式的畫面。

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

如需詳細資訊，請參閱 KS 配置器。

規格需求

另請參閱

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN

KSPIN_DISPATCH