mmioCreateChunk 함수(mmiscapi.h)

  • 아티클

mmioCreateChunk 함수는 mmioOpen 함수를 사용하여 연 RIFF 파일에 청크를 만듭니다. 새 청크는 현재 파일 위치에 만들어집니다. 새 청크를 만든 후 현재 파일 위치는 새 청크의 데이터 부분의 시작 부분입니다.

구문

MMRESULT mmioCreateChunk(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuCreate
);

매개 변수

hmmio

열려 있는 RIFF 파일의 파일 핸들입니다.

pmmcki

만들 청크에 대한 정보가 포함된 MMCKINFO 구조를 수신하는 버퍼에 대한 포인터입니다.

fuCreate

만들 청크의 유형을 식별하는 플래그입니다. 다음 값이 정의됩니다.

값 의미
MMIO_CREATELIST "LIST" 청크.
MMIO_CREATERIFF "RIFF" 청크.

반환 값

성공하거나 오류가 있으면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MMIOERR_CANNOTSEEK
 청크의 데이터 부분 오프셋을 확인할 수 없습니다.
MMIOERR_CANNOTWRITE
 청크 헤더를 쓸 수 없습니다.

설명

이 함수는 파일 중간에 청크를 삽입할 수 없습니다. 애플리케이션이 파일의 끝부분이 아닌 다른 곳에 청크를 만들려고 하면 mmioCreateChunk 는 파일의 기존 정보를 덮어씁니다.

lpck 매개 변수가 가리키는 MMCKINFO 구조체는 다음과 같이 설정해야 합니다.

  • ckid 멤버는 청크 식별자를 지정합니다. wFlags에 MMIO_CREATERIFF 또는 MMIO_CREATELIST 포함된 경우 이 멤버는 mmioCreateChunk로 채워집니다.
  • cksize 멤버는 양식 유형 또는 목록 형식(있는 경우)을 포함하여 청크의 데이터 부분 크기를 지정합니다. mmioAscend 함수를 호출하여 청크의 끝을 표시할 때 이 값이 올바르지 않으면 mmioAscend는 청크 크기를 수정합니다.
  • 청크가 "RIFF" 또는 "LIST" 청크인 경우 fccType 멤버는 양식 유형 또는 목록 형식을 지정합니다. 청크가 "RIFF" 또는 "LIST" 청크가 아닌 경우 이 멤버를 채울 필요가 없습니다.
  • dwDataOffset 멤버를 채울 필요가 없습니다. mmioCreateChunk 함수는 이 멤버를 청크 데이터 부분의 파일 오프셋으로 채웁니다.
  • dwFlags 멤버를 채울 필요가 없습니다. mmioCreateChunk 함수는 dwFlags에서 MMIO_DIRTY 플래그를 설정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mmiscapi.h(Mmiscapi.h, Windows.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll