ACMFORMATTAGDETAILS 구조체(msacm.h)
ACMFORMATTAGDETAILS 구조체는 ACM 드라이버에 대한 파형 오디오 형식 태그를 자세히 설명합니다.
구문
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
멤버
cbStruct
ACMFORMATTAGDETAILS 구조체의 크기(바이트)입니다. 애플리케이션이 acmFormatTagDetails 또는 acmFormatTagEnum 함수를 호출하기 전에 이 멤버를 초기화해야 합니다. 이 멤버가 지정한 크기는 기본 ACMFORMATTAGDETAILS 구조를 포함할 수 있을 만큼 커야 합니다. acmFormatTagDetails 함수가 반환되면 이 멤버는 반환되는 정보의 실제 크기를 포함합니다. 반환된 정보는 요청된 크기를 초과하지 않습니다.
dwFormatTagIndex
세부 정보를 검색할 형식 태그의 인덱스입니다. 인덱스 범위는 ACM 드라이버에서 지원하는 형식 태그 수보다 0개에서 1개 미만입니다. 드라이버에서 지원하는 형식 태그의 수는 ACMDRIVERDETAILS 구조에 포함되어 있습니다. dwFormatTagIndex 멤버는 인덱스별로 드라이버에 대한 형식 태그 세부 정보를 쿼리할 때만 사용됩니다. 그렇지 않으면 이 멤버는 0이어야 합니다.
dwFormatTag
ACMFORMATTAGDETAILS 구조체에서 설명하는 파형 오디오 형식 태그입니다. 이 멤버는 ACM_FORMATTAGDETAILSF_FORMATTAG 및 ACM_FORMATTAGDETAILSF_LARGESTSIZE 쿼리 플래그에 대한 입력에 사용됩니다. acmFormatTagDetails 함수가 성공하면 이 멤버가 항상 반환됩니다. 이 멤버는 다른 모든 쿼리 플래그에 대해 WAVE_FORMAT_UNKNOWN 설정해야 합니다.
cbFormatSize
dwFormatTag 형식의 파형 오디오 형식 중 가장 큰 총 크기(바이트)입니다. 예를 들어 이 멤버는 WAVE_FORMAT_PCM 16, WAVE_FORMAT_ADPCM 50이 됩니다.
fdwSupport
형식 태그와 관련된 드라이버 지원 플래그입니다. 이러한 플래그는 ACMDRIVERDETAILS 구조체와 동일합니다. 이 멤버는 다음 값의 일부 조합일 수 있으며 드라이버가 형식 태그를 사용하여 지원하는 작업을 참조할 수 있습니다.
| Name | Description |
|---|---|
|
드라이버는 지정된 형식 태그를 사용하여 비동기 변환을 지원합니다. |
|
드라이버는 태그 중 하나가 지정된 형식 태그인 두 개의 서로 다른 형식 태그 간 변환을 지원합니다. 예를 들어 드라이버가 WAVE_FORMAT_PCM WAVE_FORMAT_ADPCM 압축을 지원하는 경우 이 플래그가 설정됩니다. |
|
드라이버는 지정된 형식 태그의 서로 다른 두 형식 간 변환을 지원합니다. 예를 들어 드라이버가 WAVE_FORMAT_PCM 다시 샘플링을 지원하는 경우 이 플래그가 설정됩니다. |
|
드라이버는 필터를 지원합니다(형식 특성을 변경하지 않고 데이터 수정). 예를 들어 드라이버가 지정된 형식 태그에서 볼륨 또는 에코 작업을 지원하는 경우 이 플래그가 설정됩니다. |
|
드라이버는 파형 오디오 디바이스를 통해 지정된 형식 태그의 하드웨어 입력, 출력 또는 둘 다를 지원합니다. 애플리케이션은 acmMetrics 함수를 ACM_METRIC_HARDWARE_WAVE_INPUT 및 ACM_METRIC_HARDWARE_WAVE_OUTPUT 메트릭 인덱스와 함께 사용하여 지원 ACM 드라이버와 연결된 파형 오디오 디바이스 식별자를 가져와야 합니다. |
cStandardFormats
dwFormatTag 형식의 표준 형식 수입니다. 즉, 모든 샘플 속도, 샘플당 비트, 채널 등의 조합입니다. 이 값은 드라이버에서 지원하는 모든 형식을 지정할 수 있지만 반드시 지정할 필요는 없습니다.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
dwFormatTag 형식을 설명하는 문자열입니다. acmFormatTagDetails 함수가 성공하면 이 문자열이 항상 반환됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | msacm.h |