MCI_SYSINFO 명령

  • 아티클

MCI_SYSINFO 명령은 MCI 디바이스에 대한 정보를 검색합니다. MCI는 이 명령을 디바이스에 전달하는 대신 직접 지원합니다. 모든 MCI 애플리케이션은 이 명령을 사용할 수 있습니다. 문자열 정보는 lpSysInfo로 식별된 구조체의 lpstrReturn 멤버가 가리키는 애플리케이션 제공 버퍼에 반환됩니다. 숫자 정보는 애플리케이션에서 제공하는 버퍼에 배치된 DWORD 값으로 반환됩니다. dwRetSize 멤버는 버퍼 길이를 지정합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SYSINFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);

매개 변수

wDeviceID

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

dwFlags

다음 표준 및 명령별 플래그 중 하나 이상:

MCI_SYSINFO_INSTALLNAME

디바이스를 설치하는 데 사용되는 이름(레지스트리 또는 SYSTEM.INI 파일에 나열됨)을 가져옵니다.

MCI_SYSINFO_NAME

lpSysInfo로 식별된 구조체의 dwNumber 멤버에 지정된 디바이스 번호에 해당하는 디바이스 이름을 가져옵니다. MCI_SYSINFO_OPEN 플래그가 설정된 경우 MCI는 열려 있는 디바이스의 이름을 반환합니다.

MCI_SYSINFO_OPEN

열려 있는 디바이스의 수량 또는 이름을 가져옵니다.

MCI_SYSINFO_QUANTITY

레지스트리 또는 SYSTEM.INI 파일의 [mci] 섹션에 나열된 지정된 형식의 디바이스 수를 가져옵니다. MCI_SYSINFO_OPEN 플래그가 설정되면 열려 있는 디바이스 수가 반환됩니다.

lpSysInfo

MCI_SYSINFO_PARMS 구조체에 대한 포인터입니다.

반환 값

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

설명

lpSysInfo로 식별된 구조체의 wDeviceType 멤버는 쿼리의 디바이스 유형을 나타내는 데 사용됩니다. wDeviceID 매개 변수가 MCI_ALL_DEVICE_ID 설정되면 wDeviceType 값을 재정의합니다. 디바이스 유형 목록은 MCI 디바이스 유형을 참조하세요.

정수 반환 값은 lpSysInfo로 식별된 구조체의 lpstrReturn 멤버가 가리키는 버퍼에서 반환되는 DWORD 값입니다.

문자열 반환 값은 lpSysInfo로 식별된 구조체의 lpstrReturn 멤버가 가리키는 버퍼에서 반환되는 null로 끝나는 문자열입니다.

요구 사항

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

추가 정보

Mci

MCI 명령