Graphisoft®

GSRootVersion: 1.0

BMAllocateHandle

BMAllocateHandle 함수는 지정한 크기의 재배치 가능 메모리 블록을 할당합니다. 그리고 할당된 블록을 참조하는 핸들을 리턴합니다.

GSHandle BMAllocateHandle(
  GSSize          nBytes,        // 할당할 바이트 수
  GSFlags         allocFlags,    // 할당 속성
  short           actionCode     // 사용자 지정 코드
);

 

파라미터

nBytes
재배치 가능 메모리의 블록의 요청 크기(바이트 수)를 지정합니다.
allocFlags
어떻게 메모리를 할당할지 지정합니다. 이 파라미터는 다음 값들 중 아무 조합이 될 수 있습니다.
의미
ALLOCATE_ACTION 사용자 액션이 활성화되었습니다.
ALLOCATE_CLEAR 메모리 블록이 제로(0)로 채워집니다.
ALLOCATE_EMPTY 빈 핸들이 할당되었습니다.
actionCode
오류 위치 또는 함수를 구분하기 위한 사용자 지정 코드입니다.

리턴 값

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

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

설명

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

요구사항

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

참고사항

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