IMemInputPin::GetAllocator
GetAllocator メソッドは、このピンが提案したメモリ アロケータを取得する。アロケータが選択された後は、このメソッドは選択されたアロケータへのポインタを返す。
構文
HRESULT GetAllocator(
IMemAllocator **ppAllocator
);
パラメータ
ppAllocator
[out] アロケータの IMemAllocator インターフェイスへのポインタを受け取る変数のアドレス。
戻り値
HRESULT 値を返す。可能な値は次の一覧のとおりである。
値 | 説明 |
S_OK | 成功。 |
VFW_E_NO_ALLOCATOR | 利用可能なアロケータがない。 |
注意
出力ピンは入力ピンと接続するとき、入力ピンにメモリ アロケータを決めるようにネゴシエートする。出力ピンはこのメソッドを呼び出して入力ピンの提案したアロケータを取得する。その出力ピンは IMemInputPin::NotifyAllocator メソッドを呼び出して、どのアロケータを選択したかを指定する。
このメソッドが成功すると、IMemAllocator インターフェイスに未処理の参照カウントが残る。使った後は、必ず解放すること。
参照