PFNKSPININITIALIZEALLOCATOR コールバック関数 (ks.h)

AVStream ミニドライバーの 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 情報にアクセスできる必要があります。また、AVStream が渡すパラメーターは Context だけです)。

戻り値

AVStrMiniInitializeAllocator は、STATUS_SUCCESSまたはアロケーターの作成を試みるために受け取ったエラー コードを返す必要があります。

注釈

ミニドライバーは、そのKSALLOCATOR_DISPATCH構造体の InitializeAllocator メンバーで、このルーチンのアドレスを指定します。 ミニドライバーは、この構造体を KSPIN_DISPATCH のクラス ドライバーに渡します。

カーネル モード アロケーターは、最終的にユーザー モードに到達する可能性があるフレームを割り当てることができないことに注意してください。

AVStream は AVStrMiniInitializeAllocator を呼び出して、指定されたアロケーターを初期化します。 このルーチンのハンドラーは、メモリ割り当てと空き要求を処理する準備をする必要があります。

詳細については、「 KS アロケーター」を参照してください。

要件

こちらもご覧ください

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN

KSPIN_DISPATCH