IAllocatorMXF::GetBuffer メソッド (dmusicks.h)

[アーティクル]
02/23/2024

メソッドは GetBuffer 、長い MIDI イベントにバッファーを割り当てます。

構文

NTSTATUS GetBuffer(
  [out] PBYTE *ppBuffer
);

パラメーター

[out] ppBuffer

バッファーの出力ポインター。このパラメーターは、メソッドがバッファーへのポインターを書き込む呼び出し元によって割り当てられたポインター変数を指します。

戻り値

GetBuffer は、呼び出しが成功した場合にS_OKを返します。それ以外の場合、メソッドは適切なエラーコードを返します。

注釈

ミニポートドライバーは、キャプチャシンクにデータの大きなチャンクを送信する必要がある場合にのみ、このメソッドを呼び出します。具体的には、ミニポートドライバーは、コンポーネントが DMUS_KERNEL_EVENT の uData メンバーに格納できるよりも多くのデータをパッケージ化する必要がある場合は常に、このメソッドを使用します。

バッファーのサイズは、 IAllocatorMXF::GetBufferSize を呼び出すことによって決定できます。 GetBufferSize バッファーサイズはアロケーターの実装に対して一定であるため、1 回だけ呼び出す必要があります。