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 の呼び出しは、スレッド セーフであることが保証されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |