MCI_INFO 명령

  • 아티클

MCI_INFO 명령은 디바이스에서 문자열 정보를 검색합니다. 모든 디바이스는 이 명령을 인식합니다. lpInfo로 식별된 구조체의 lpstrReturn 멤버에 정보가 반환됩니다. dwRetSize 멤버는 반환된 데이터의 버퍼 길이를 지정합니다.

이 명령을 보내려면 다음 매개 변수를 사용하여 mciSendCommand 함수를 호출합니다.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

매개 변수

wDeviceID

명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.

dwFlags

디지털 비디오 및 VCR 디바이스의 경우 MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpInfo

MCI_INFO_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 대체할 수 있습니다.)

반환 값

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

설명

다음 추가 표준 및 명령별 플래그는 MCI_INFO 지원하는 모든 디바이스에 적용됩니다.

MCI_INFO_PRODUCT

디바이스와 연결된 하드웨어에 대한 설명을 가져옵니다. 디바이스는 사용된 드라이버와 하드웨어를 모두 식별하는 설명을 제공해야 합니다.

cdaudio 디바이스 유형에는 다음과 같은 추가 플래그가 적용됩니다.

MCI_INFO_MEDIA_IDENTITY

쿼리 중인 플레이어에 현재 로드된 오디오 CD에 대한 고유 식별자를 생성합니다. 이 플래그는 166진수 문자열을 반환합니다.

MCI_INFO_MEDIA_UPC

오디오 CD에 인코딩된 UPC(유니버설 제품 코드)를 생성합니다. UPC는 숫자 문자열입니다. 모든 CD에 사용할 수 없는 경우도 있습니다.

digitalvideo 디바이스 유형에는 다음과 같은 추가 플래그가 적용됩니다.

MCI_DGV_INFO_ITEM

원하는 정보를 나타내는 상수는 lpInfo로 식별된 구조체의 dwItem 멤버에 포함됩니다. 디지털 비디오 디바이스에 대해 다음과 같은 상수가 정의됩니다.

MCI_DGV_INFO_AUDIO_ALG

현재 오디오 압축 알고리즘의 이름을 반환합니다.

MCI_DGV_INFO_AUDIO_QUALITY

현재 오디오 품질 설명자의 이름을 반환합니다.

MCI_DGV_INFO_STILL_ALG

현재 스틸 이미지 압축 알고리즘의 이름을 반환합니다.

MCI_DGV_INFO_STILL_QUALITY

현재 스틸 이미지 품질 설명자의 이름을 반환합니다.

MCI_DGV_INFO_USAGE

작업 영역에서 시각적 개체 또는 가청 데이터의 소유자가 부과할 수 있는 사용 제한을 설명하는 문자열을 반환합니다.

MCI_DGV_INFO_VIDEO_ALG

현재 비디오 압축 알고리즘의 이름을 반환합니다.

MCI_DGV_INFO_VIDEO_QUALITY

현재 비디오 품질 설명자의 이름을 반환합니다.

MCI_INFO_VERSION

디바이스 드라이버 및 하드웨어의 릴리스 수준을 반환합니다. 디바이스 드라이버 개발자는 반환된 문자열의 구문을 문서화해야 합니다.

MCI_DGV_INFO_TEXT

창 캡션 가져옵니다.

MCI_INFO_FILE

MCI_OPEN 또는 MCI_LOAD 명령으로 지정된 마지막 파일의 경로와 파일 이름을 가져옵니다. 파일을 지정하지 않은 경우 디바이스는 null로 끝나는 문자열을 반환합니다. 이 플래그는 TRUE 를 MCI_GETDEVCAPS 명령의 MCI_GETDEVCAPS_USES_FILES 플래그로 반환하는 디바이스에서만 지원됩니다.

디지털 비디오 디바이스의 경우 lpInfo 는 MCI_DGV_INFO_PARMS 구조를 가리킵니다.

다음 추가 플래그는 시퀀서 디바이스 유형에 적용됩니다.

MCI_INFO_COPYRIGHT

저작권 메타 이벤트에서 MIDI 파일 저작권 통지를 받습니다.

MCI_INFO_FILE

현재 파일의 파일 이름을 가져옵니다. 이 플래그는 MCI_GETDEVCAPS_USES_FILES 플래그를 사용하여 MCI_GETDEVCAPS 명령을 호출할 때 TRUE를 반환하는 디바이스에서만 지원됩니다.

MCI_INFO_NAME

시퀀스/트랙 이름 메타 이벤트에서 시퀀스 이름을 가져옵니다.

다음 추가 플래그는 vcr 디바이스 유형에 적용됩니다.

MCI_VCR_INFO_VERSION

버전 번호를 가리키도록 MCI_INFO_PARMS 구조체의 lpstrReturn 멤버를 설정합니다. 또한 dwRetSize 멤버를 가리키는 문자열의 길이와 동일하게 설정합니다.

오버레이 디바이스 유형에 적용되는 추가 플래그는 다음과 같습니다.

MCI_INFO_FILE

현재 파일의 파일 이름을 가져옵니다. 이 플래그는 TRUE 를 MCI_GETDEVCAPS 명령의 MCI_GETDEVCAPS_USES_FILES 플래그로 반환하는 디바이스에서만 지원됩니다.

MCI_OVLY_INFO_TEXT

비디오 오버레이 디바이스와 연결된 창의 캡션 가져옵니다.

다음과 같은 추가 플래그가 waveaudio 디바이스 유형에 적용됩니다.

MCI_INFO_FILE

현재 파일의 파일 이름을 가져옵니다. 이 플래그는 MCI_GETDEVCAPS_USES_FILES 플래그를 사용하여 MCI_GETDEVCAPS 명령을 호출할 때 TRUE를 반환하는 디바이스에서 지원됩니다.

MCI_WAVE_INPUT

현재 입력의 제품 이름을 가져옵니다.

MCI_WAVE_OUTPUT

현재 출력의 제품 이름을 가져오고 해당 값은 디바이스에 따라 다릅니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Mmsystem.h(Windows.h 포함)

추가 정보

Mci

MCI 명령