次の方法で共有

_expand_dbg

  • [アーティクル]

ブロック (デバッグ バージョンだけ) を配置または表示するにはヒープ上のメモリの指定されたブロックのサイズを変更します。

void *_expand_dbg( 
   void *userData,
   size_t newSize,
   int blockType,
   const char *filename,
   int linenumber 
);

パラメーター

  • userData
    既に割り当てられたメモリ ブロックへのポインター。

  • newSize
    ブロックの要求時に新しいサイズ (バイト単位)。

  • blockType
    サイズ変更されたブロックで要求された型 : _CLIENT_BLOCK または _NORMAL_BLOCK。

  • filename
    要求された操作または NULL を配置するソース ファイルの名前へのポインター。

  • linenumber
    配置操作が要求または NULL のソース ファイルの行番号。

filename と linenumber のパラメーターは _expand_dbg が明示的に呼び出されたときまたは _CRTDBG_MAP_ALLOC のプリプロセッサ定数が定義されたのみ使用できます。

戻り値

正常に終了した場合_expand_dbg のサイズが変更されたメモリ ブロックへのポインターを返します。メモリが移動しないためアドレスは userData と同じです。エラーが発生した場合またはブロックが要求されたサイズに配置できる NULL を返します。エラーが発生 errno は失敗の種類に関するオペレーティング システムによる情報とあります。errno の詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

解説

_expand_dbg の関数は現在の 配置します。 の関数のデバッグ バージョンです。_DEBUG を定義しない場合_expand_dbg を呼び出すたびに_expand の呼び出しに減少します。_expand と _expand_dbg はベース ヒープ メモリ ブロックのサイズが変更されますが_expand_dbg は一部のデバッグ機能が格納されます : 調べ割り当て要求の原点を確認するために特定の割り当て型を追跡するブロック型パラメーターと filename と linenumber 情報のテスト対象ブロックのユーザー領域の前後に確保されるバッファー。

_expand_dbg は要求された newSize よりもより多くのスペースを指定されたメモリ ブロックのサイズを変更します。newSize割り当てられたメモリ ブロックのサイズは元により大きいか小さいかである可能性があります。デバッグ ヒープ マネージャーによって追加空間がデバッグ メモリ ブロックをリンクするとアプリケーションのデバッグのヘッダー情報とバッファーをオーバーライドするために使用されます。サイズ変更は元のメモリ ブロックを配置または表示によって実現されます。_expand_dbg は _realloc_dbg の関数と同様にメモリ ブロックを移動しません。

newSize が元のブロック サイズよりも大きい場合そのメモリ ブロックが配置されます。配置中に要求されたサイズに応じてメモリ ブロックを配置できない場合 NULL が返されます。newSize が元のブロック サイズ未満の場合メモリ ブロックは新しいサイズが小さくするまで。

デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「メモリ管理とデバッグ ヒープ」を参照してください。割り当てブロックの型についてはそれらがどのように使用されるかについてはデバッグ ヒープ ブロックの型 を参照してください。アプリケーションのデバッグ ビルドの標準とデバッグ バージョンのヒープ関数呼び出しの違いについてはデバッグ バージョンを使用して基本バージョン を参照してください。

この関数は、パラメーターを検証します。memblock が null ポインターの場合またはサイズが _HEAP_MAXREQ の場合この関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、errno が EINVAL に設定され、関数から NULL が返されます。

必要条件

ルーチン

必須ヘッダー

_expand_dbg

<crtdbg.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

C ランタイム ライブラリのデバッグ バージョンのみ。

使用例

// crt_expand_dbg.c
//
// This program allocates a block of memory using _malloc_dbg
// and then calls _msize_dbg to display the size of that block.
// Next, it uses _expand_dbg to expand the amount of
// memory used by the buffer and then calls _msize_dbg again to
// display the new amount of memory allocated to the buffer.
//

#include <stdio.h>
#include <malloc.h>
#include <stdlib.h>
#include <crtdbg.h>

int main( void )
{
   long *buffer;
   size_t size;

   // Call _malloc_dbg to include the filename and line number
   // of our allocation request in the header
   buffer = (long *)_malloc_dbg( 40 * sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );
   if( buffer == NULL )
      exit( 1 );

   // Get the size of the buffer by calling _msize_dbg
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _malloc_dbg of 40 longs: %u\n", size );

   // Expand the buffer using _expand_dbg and show the new size
   buffer = (long *)_expand_dbg( buffer, size + sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );

   if( buffer == NULL )
      exit( 1 );
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _expand_dbg of 1 more long: %u\n",
           size );

   free( buffer );
   exit( 0 );
}

コメント

このプログラムの出力はすべてのセクションを配置するコンピューターの機能によって異なります。すべてのセクションが展開されて出力セクションに反映されます。

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

デバッグ ルーチン

_malloc_dbg