AVISTREAMINFOW 구조체(vfw.h)

아티클
08/27/2023

AVISTREAMINFO 구조체에는 단일 스트림에 대한 정보가 포함됩니다.

구문

typedef struct _AVISTREAMINFOW {
  DWORD fccType;
  DWORD fccHandler;
  DWORD dwFlags;
  DWORD dwCaps;
  WORD  wPriority;
  WORD  wLanguage;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwStart;
  DWORD dwLength;
  DWORD dwInitialFrames;
  DWORD dwSuggestedBufferSize;
  DWORD dwQuality;
  DWORD dwSampleSize;
  RECT  rcFrame;
  DWORD dwEditCount;
  DWORD dwFormatChangeCount;
  WCHAR szName[64];
} AVISTREAMINFOW, *LPAVISTREAMINFOW;

멤버

fccType

스트림 형식을 나타내는 4자 코드입니다. AVI 스트림에서 일반적으로 발견되는 데이터에 대해 다음 상수가 정의되었습니다.

상수	설명
streamtypeAUDIO	오디오 스트림을 나타냅니다.
streamtypeMIDI	MIDI 스트림을 나타냅니다.
streamtypeTEXT	텍스트 스트림을 나타냅니다.
streamtypeVIDEO	비디오 스트림을 나타냅니다.

fccHandler

저장될 때 이 비디오 스트림을 압축하는 압축기 처리기의 4자 코드입니다(예: mmioFOURCC ('M','S','V','C')). 이 멤버는 오디오 스트림에 사용되지 않습니다.

dwFlags

스트림에 적용 가능한 플래그입니다. 이러한 플래그의 상위 단어에 있는 비트는 스트림에 포함된 데이터 형식에 따라 다릅니다. 다음 플래그가 정의됩니다.

Name	설명
AVISTREAMINFO_DISABLED	사용자가 명시적으로 사용하도록 설정할 때 이 스트림을 렌더링해야 했음을 나타냅니다.
AVISTREAMINFO_FORMATCHANGES	이 비디오 스트림에 색상표 변경 내용이 포함되어 있음을 나타냅니다. 이 플래그는 팔레트에 애니메이션 효과를 주어야 한다는 것을 재생 소프트웨어에 경고합니다.

dwCaps

기능 플래그; 현재 사용되지 않습니다.

wPriority

스트림의 우선 순위입니다.

wLanguage

스트림의 언어입니다.

dwScale

스트림에 적용할 수 있는 시간 크기 조정입니다. dwScale로 dwRate를 나누면 재생 속도가 초당 샘플 수로 표시됩니다.

비디오 스트림의 경우 이 속도는 프레임 속도여야 합니다. 오디오 스트림의 경우 이 속도는 오디오 블록 크기(WAVEFORMAT 또는 PCMWAVEFORMAT 구조의 nBlockAlign 멤버)에 해당해야 하며, PCM(펄스 코드 변조) 오디오의 경우 샘플 속도로 감소합니다.

dwRate

정수 형식의 속도입니다. 초당 샘플의 속도를 가져오려면 이 값을 dwScale의 값으로 나눕니다.

dwStart

AVI 파일의 첫 번째 프레임 샘플 번호입니다. 단위는 dwRate 및 dwScale로 정의됩니다. 일반적으로 0이지만 파일과 동시에 시작되지 않는 스트림의 지연 시간을 지정할 수 있습니다.

AVI 도구의 1.0 릴리스는 0이 아닌 시작 시간을 지원하지 않습니다.

dwLength

이 스트림의 길이입니다. 단위는 dwRate 및 dwScale 로 정의 됩니다.

dwInitialFrames

오디오 기울이기. 이 멤버는 인터리브된 파일의 비디오 프레임보다 먼저 오디오 데이터를 기울이는 정도를 지정합니다. 일반적으로 약 0.75초입니다.

dwSuggestedBufferSize

스트림에 권장되는 버퍼 크기(바이트)입니다. 일반적으로 이 멤버는 스트림에서 가장 큰 청크에 해당하는 값을 포함합니다. 올바른 버퍼 크기를 사용하면 재생이 더 효율적입니다. 올바른 버퍼 크기를 모르는 경우 0을 사용합니다.

dwQuality

스트림의 비디오 데이터의 품질 표시기입니다. 품질은 0에서 10,000 사이의 숫자로 표시됩니다. 압축 데이터의 경우 일반적으로 압축 소프트웨어에 전달된 품질 매개 변수의 값을 나타냅니다. –1로 설정된 경우 드라이버는 기본 품질 값을 사용합니다.

dwSampleSize

단일 데이터 샘플의 크기(바이트)입니다. 이 멤버의 값이 0이면 샘플의 크기가 달라질 수 있으며 각 데이터 샘플(예: 비디오 프레임)은 별도의 청크에 있어야 합니다. 0이 아닌 값은 여러 데이터 샘플을 파일 내의 단일 청크로 그룹화할 수 있음을 나타냅니다.

비디오 스트림의 경우 이 숫자는 일반적으로 0이지만 모든 비디오 프레임의 크기가 0이 아니면 0이 아닐 수 있습니다. 오디오 스트림의 경우 이 숫자는 오디오를 설명하는 WAVEFORMAT 또는 WAVEFORMATEX 구조체의 nBlockAlign 멤버와 동일해야 합니다.

rcFrame

비디오 대상 사각형의 차원입니다. 값은 왼쪽 위 모서리의 좌표, 높이 및 사각형의 너비를 나타냅니다.

dwEditCount

스트림이 편집된 횟수입니다. 스트림 처리기는 이 수를 유지 관리합니다.

dwFormatChangeCount

스트림 형식이 변경된 횟수입니다. 스트림 처리기는 이 수를 유지 관리합니다.

szName[64]

스트림에 대한 설명을 포함하는 Null로 끝나는 문자열입니다.

설명

참고

vfw.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 AVISTREAMINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	vfw.h