mmioAscend 함수(mmiscapi.h)

  • 아티클

mmioAscend 함수는 mmioDescend 함수를 사용하여 내림차순으로 내림차순으로 또는 mmioCreateChunk 함수를 사용하여 만든 RIFF 파일의 청크에서 오름차순으로 상승합니다.

구문

MMRESULT mmioAscend(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuAscend
);

매개 변수

hmmio

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

pmmcki

이전에 mmioDescend 또는 mmioCreateChunk 함수로 채워진 애플리케이션 정의 MMCKINFO 구조체에 대한 포인터입니다.

fuAscend

예약; 0이어야 합니다.

반환 값

성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MMIOERR_CANNOTSEEK
 청크의 끝을 찾는 동안 오류가 발생했습니다.
MMIOERR_CANNOTWRITE
 버퍼의 내용을 디스크에 쓸 수 없습니다.

설명

mmioDescend를 사용하여 청크를 내림차순으로 지정한 경우 mmioAscend는 청크의 끝 다음에 있는 위치를 찾습니다(추가 패드 바이트를 지나면).

mmioCreateChunk를 사용하여 청크를 만들고 내림차순으로 만들거나 lpck에서 참조하는 MMCKINFO 구조체의 dwFlags 멤버에서 MMIO_DIRTY 플래그가 설정된 경우 현재 파일 위치는 청크의 데이터 부분 끝으로 간주됩니다. 청크 크기가 mmioCreateChunk가 호출되었을 때 MMCKINFO 구조체의 cksize 멤버에 저장된 값과 같지 않은 경우 mmioAscend는 청크에서 오름차순으로 올라가기 전에 파일의 청크 크기를 수정합니다. 청크 크기가 홀수이면 mmioAscend 는 청크 끝에 null 패드 바이트를 씁니다. 청크에서 오름차순으로 이동한 후 현재 파일 위치는 청크 끝(추가 패드 바이트(있는 경우)을 지나는 위치입니다.

요구 사항

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