CMediaType.ReallocFormatBuffer メソッド
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは ReallocFormatBuffer
、書式ブロックを新しいサイズに再割り当てします。
構文
BYTE* ReallocFormatBuffer(
ULONG length
);
パラメーター
-
length
-
フォーマット ブロックに必要な新しいサイズ (バイト単位)。 0 より大きくなければなりません。
戻り値
成功した場合は、新しいブロックへのポインターを返します。 それ以外の場合は、古い書式ブロックへのポインターまたは NULL を返します。
解説
このメソッドは、新しい書式ブロックを割り当てます。 既存のフォーマット ブロックのできるだけ多くを新しいフォーマット ブロックにコピーします。 新しいブロックが既存のブロックより小さい場合、既存のフォーマット ブロックは切り捨てられます。 新しいブロックが大きい場合、追加スペースの内容は未定義になります。 明示的に 0 に設定されていません。
メソッドは、AM_MEDIA_TYPE構造体の cbFormat メンバーと pbFormat メンバーを更新します。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|