Graphisoft®

GSRootVersion: 1.0

BMReallocHandle

BMReallocHandle 함수는 지정한 크기로 재배치 가능 메모리 블록을 재할당합니다.

GSHandle BMReallocHandle(
  GSHandle  h,                 // 재할당 하고자 하는 핸들
  GSSize    nBytes,            // 바이트 수
  GSFlags   reallocFlags,      // 재할당 속성
  short   actionCode           // 사용자 지정 코드
);

 

파라미터

h
재할당하려는 재배치 가능 메모리 블록에 대한 핸들을 지정합니다.
nBytes
재배치 가능 메모리 블록의 원하는 크기(바이트 수)를 지정합니다.
reallocFlags
어떻게 메모리를 재할당할지 지정합니다. 이 파라미터는 다음 값들 중 아무 조합이 될 수 있습니다:
의미
REALLOC_ACTION 사용자 액션이 활성화되었습니다.
REALLOC_CLEAR 새로 할당된 메모리 블록을 제로(0)로 채웁니다.
REALLOC_FULLCLEAR 전체 메모리 블록을 제로(0)로 채웁니다.
REALLOC_SHRINK 새 크기가 예전보다 작아야 합니다.
REALLOC_DISPOSE 만약 재할당에 실패하면 폐기합니다.
REALLOC_MOVEABLE 새로운 메모리 블록은 이동 가능합니다.
actionCode
BMOptProc 함수에 대한 사용자 지정 코드입니다.

리턴 값

만약 함수가 성공하면, 리턴 값은 요청한 크기의 할당된 메모리 블록을 참조하는 핸들입니다.

만약 함수가 실패하면, 리턴 값은 NULL입니다.

설명

만약 핸들이 기존 블록을 참조하면, BMReallocHandle은 새로운 것을 생성하기 전에 기존 메모리 블록을 해제합니다.

새로운 블록은 잠겨 있지 않으며, 제거할 수 없고, 리소스가 아닙니다.

요구사항

    헤더: BM.hpp에서 선언됨
    라이브러리 가져오기: GSRootImp.lib와 링크

참고사항

BM 관리자 함수, BMAllocateHandle, BMKillHandle, BMOptProc