mmioGetInfo 함수(mmiscapi.h)

mmioGetInfo 함수는 mmioOpen 함수를 사용하여 연 파일에 대한 정보를 검색합니다. 이 정보를 사용하면 파일이 버퍼링된 I/O용으로 열려 있는 경우 애플리케이션이 I/O 버퍼에 직접 액세스할 수 있습니다.

구문

MMRESULT mmioGetInfo(
  HMMIO      hmmio,
  LPMMIOINFO pmmioinfo,
  UINT       fuInfo
);

매개 변수

hmmio

파일의 파일 핸들입니다.

pmmioinfo

mmioGetInfo가 파일에 대한 정보로 채우는 MMIOINFO 구조를 수신하는 버퍼에 대한 포인터입니다.

fuInfo

예약; 는 0이어야 합니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다.

설명

버퍼링된 I/O에 대해 열린 파일의 I/O 버퍼에 직접 액세스하려면 mmioGetInfo로 채워진 MMIOINFO 구조체의 다음 멤버를 사용합니다.

• pchNext 멤버는 읽거나 쓸 수 있는 버퍼의 다음 바이트를 가리킵니다. 읽거나 쓸 때 읽거나 쓴 바이트 수만큼 pchNext 를 증분합니다.
• pchEndRead 멤버는 읽을 수 있는 버퍼의 마지막 유효한 바이트를 지나 1 바이트를 가리킵니다.
• pchEndWrite 멤버는 쓸 수 있는 버퍼의 마지막 위치를 지나 1 바이트를 가리킵니다.

버퍼를 읽거나 쓰고 pchNext를 수정한 후에는 mmioSetInfo 함수를 호출할 때까지 mmioAdvance를 제외한 멀티미디어 파일 I/O 함수를 호출하지 마세요. 버퍼에 직접 액세스가 완료되면 mmioSetInfo 를 호출합니다.

pchEndRead 또는 pchEndWrite 멤버로 지정된 버퍼의 끝에 도달하면 mmioAdvance를 호출하여 디스크에서 버퍼를 채우거나 디스크에 버퍼를 씁니다. mmioAdvance 함수는 파일의 MMIOINFO 구조에서 pchNext, pchEndRead 및 pchEndWrite 멤버를 업데이트합니다.

mmioAdvance 또는 mmioSetInfo를 호출하여 버퍼를 디스크에 플러시하기 전에 파일에 대한 MMIOINFO 구조체의 dwFlags 멤버에서 MMIO_DIRTY 플래그를 설정합니다. 그렇지 않으면 버퍼가 디스크에 기록되지 않습니다.

pchNext 및 dwFlags 이외의 MMIOINFO 구조체에서 pchNext를 감소하거나 멤버를 수정하지 마세요. MMIO_DIRTY 제외하고 dwFlags에 플래그를 설정하지 마세요.

요구 사항

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