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 アロケーター」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | ks.h (Ks.h を含む) |