次の方法で共有


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 は、PinAllocatorFraming 情報にアクセスできる必要があり、AVStream が渡す唯一のパラメーターは context です)。

戻り値

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

備考

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

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

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

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

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム デスクトップ
ヘッダー ks.h (Ks.h を含む)

関連項目

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN する

KSPIN_DISPATCH