IMallocSpy::P reAlloc メソッド (objidl.h)

IMalloc::Alloc を呼び出す前に必要な操作を実行します。

構文

SIZE_T PreAlloc(
  [in] SIZE_T cbRequest
);

パラメーター

[in] cbRequest

呼び出し元が Alloc に渡す割り当て要求で指定されたバイト数。

戻り値

Alloc の呼び出しで指定されたバイト数。cbRequest の値以上の値を指定できます。

注釈

PreAlloc 実装では、割り当てを拡張または変更して、割り当てと共にデバッグ固有の情報を格納できます。

PreAlloc では、0 を返すことでメモリ割り当てエラーを強制できます。これにより、すべてのケースでアプリケーションが割り当てエラーを適切に処理することをテストできます。 この場合、 IMallocSpy::P ostAlloc は呼び出されず、 Alloc は NULL を返します。 割り当てエラーの強制は、 cbRequest が 0 に等しくない場合にのみ有効です。 PreAlloc が NULL を返して強制的に失敗する場合、PostAlloc は呼び出されません。 ただし、 Alloc は実際のメモリエラーを検出し、 NULL を返します。 PostAlloc が呼び出されます。

PostAlloc からの戻り値を介した PreAlloc の呼び出しは、スレッド セーフであることが保証されます。

要件

こちらもご覧ください

IMalloc::Alloc

IMallocSpy

IMallocSpy::P ostAlloc