다음을 통해 공유

mmioSetBuffer 함수(mmiscapi.h)

  • 아티클

mmioSetBuffer 함수는 버퍼링된 I/O를 사용하거나 사용하지 않도록 설정하거나 mmioOpen 함수를 사용하여 연 파일의 버퍼 또는 버퍼 크기를 변경합니다.

구문

MMRESULT mmioSetBuffer(
  HMMIO hmmio,
  LPSTR pchBuffer,
  LONG  cchBuffer,
  UINT  fuBuffer
);

매개 변수

hmmio

파일의 파일 핸들입니다.

pchBuffer

버퍼링된 I/O에 사용할 애플리케이션 정의 버퍼에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 mmioSetBuffer 는 버퍼링된 I/O에 대한 내부 버퍼를 할당합니다.

cchBuffer

애플리케이션 정의 버퍼의 크기(문자 단위) 또는 mmioSetBuffer 가 할당할 버퍼의 크기입니다.

fuBuffer

예약; 0이어야 합니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다. 오류가 발생하면 파일 핸들이 유효한 상태로 유지됩니다. 다음 값이 정의됩니다.

반환 코드 설명
MMIOERR_CANNOTWRITE
 이전 버퍼의 내용을 디스크에 쓸 수 없으므로 작업이 중단되었습니다.
MMIOERR_OUTOFMEMORY
 사용 가능한 메모리 부족으로 인해 새 버퍼를 할당할 수 없습니다.

설명

내부 버퍼를 사용하여 버퍼링을 사용하도록 설정하려면 pchBuffer 를 NULL 로 설정하고 cchBuffer 를 원하는 버퍼 크기로 설정합니다.

사용자 고유의 버퍼를 제공하려면 pchBuffer 를 버퍼를 가리키도록 설정하고 cchBuffer 를 버퍼 크기로 설정합니다.

버퍼링된 I/O를 사용하지 않도록 설정하려면 pchBuffer 를 NULL 로 설정하고 cchBuffer 를 0으로 설정합니다.

내부 버퍼를 사용하여 버퍼링된 I/O를 이미 사용하도록 설정한 경우 pchBuffer 를 NULL 로 설정하고 cchBuffer 를 새 버퍼 크기로 설정하여 버퍼를 다른 크기로 다시 할당할 수 있습니다. 크기 조정 후 버퍼의 내용을 변경할 수 있습니다.

요구 사항

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