MCI_OPEN 명령

MCI_OPEN 명령은 디바이스 또는 파일을 초기화합니다. 모든 디바이스는 이 명령을 인식합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_OPEN, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_OPEN_PARMS) lpOpen
);

매개 변수

wDeviceID

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

dwFlags

MCI_NOTIFY 또는 MCI_WAIT. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpOpen

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

반환 값

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

설명

디바이스가 mciSendCommand 함수에 지정될 때마다 MCI_OPEN_TYPE 플래그를 사용해야 합니다. 디바이스 유형 상수를 지정하여 디바이스를 여는 경우 MCI_OPEN_TYPE 외에도 MCI_OPEN_TYPE_ID 플래그를 지정해야 합니다. 디바이스 유형 상수 목록은 MCI 디바이스 유형을 참조하세요.

디바이스 또는 파일을 처음 열 때 MCI_OPEN_SHAREABLE 플래그를 지정하지 않으면 디바이스 또는 파일에 대한 모든 후속 MCI_OPEN 명령이 실패합니다. 디바이스 또는 파일이 이미 열려 있고 이 플래그가 지정되지 않은 경우 첫 번째 열린 명령이 MCI_OPEN_SHAREABLE 경우에도 호출이 실패합니다. MCISEQ에 대해 열린 파일입니다. DRV 및 MCIWAVE. DRV 디바이스는 공유할 수 없습니다.

디바이스 이름에서는 대/소문자를 무시하지만 선행 또는 후행 공백은 있을 수 없습니다.

레지스트리의 항목을 통해 자동 형식 선택을 사용하려면 lpOpen으로 식별된 구조체의 lpstrElementName 멤버에 파일 이름 및 파일 확장자를 할당하고 lpstrDeviceType 멤버를 NULL로 설정하고 MCI_OPEN_ELEMENT 플래그를 설정합니다.

다음 추가 플래그는 MCI_OPEN 지원하는 모든 디바이스에 적용됩니다.

MCI_OPEN_ALIAS

별칭은 lpOpen으로 식별된 구조체의 lpstrAlias 멤버에 포함됩니다.

MCI_OPEN_SHAREABLE

디바이스 또는 파일을 공유 가능으로 열어야 합니다.

MCI_OPEN_TYPE

디바이스 유형 이름 또는 상수는 lpOpen으로 식별된 구조체의 lpstrDeviceType 멤버에 포함됩니다.

MCI_OPEN_TYPE_ID

lpOpen으로 식별된 구조체의 lpstrDeviceType 멤버의 하위 단어에는 표준 MCI 디바이스 유형 식별자가 포함되며, 고차 단어에는 필요에 따라 디바이스의 서수 인덱스가 포함됩니다. MCI_OPEN_TYPE 플래그와 함께 이 플래그를 사용합니다.

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

MCI_OPEN_ELEMENT

파일 이름은 lpOpen으로 식별된 구조체의 lpstrElementName 멤버에 포함됩니다.

MCI_OPEN_ELEMENT_ID

lpOpen으로 식별된 구조체의 lpstrElementName 멤버는 DWORD 값으로 해석되며 디바이스 내부를 의미합니다. MCI_OPEN_ELEMENT 플래그와 함께 이 플래그를 사용합니다.

다음 추가 플래그는 digitalvideo 디바이스 유형과 함께 사용됩니다.

MCI_DGV_OPEN_NOSTATIC

디바이스는 색상표의 정적(시스템) 색 수를 줄여야 합니다. 이렇게 하면 비디오 스트림을 렌더링하는 데 사용할 수 있는 색 수가 증가합니다. 이 플래그는 Windows와 팔레트를 공유하는 디바이스에만 적용됩니다.

MCI_DGV_OPEN_PARENT

부모 창 핸들은 lpOpen으로 식별된 구조체의 hWndParent 멤버에 지정됩니다.

MCI_DGV_OPEN_WS

창 스타일은 lpOpen으로 식별된 구조체의 dwStyle 멤버에 지정됩니다.

MCI_DGV_OPEN_16BIT

16비트 MCI 디바이스 지원에 대한 기본 설정을 나타냅니다.

MCI_DGV_OPEN_32BIT

32비트 MCI 디바이스 지원에 대한 기본 설정을 나타냅니다.

디지털 비디오 디바이스의 경우 lpOpen 매개 변수는 MCI_DGV_OPEN_PARMS 구조를 가리킵니다.

오버레이 디바이스 유형에 다음과 같은 추가 플래그가 사용됩니다.

MCI_OVLY_OPEN_PARENT

부모 창 핸들은 lpOpen으로 식별된 구조체의 hWndParent 멤버에 지정됩니다.

MCI_OVLY_OPEN_WS

창 스타일은 lpOpen으로 식별된 구조체의 dwStyle 멤버에 지정됩니다. dwStyle 값은 애플리케이션이 제공하지 않는 경우 드라이버가 만들고 표시할 창의 스타일을 지정합니다. style 매개 변수는 창 스타일을 정의하는 정수를 사용합니다. 이러한 상수는 표준 창 스타일(예: WS_CHILD, WS_OVERLAPPEDWINDOW 또는 WS_POPUP)과 동일합니다.

비디오 오버레이 디바이스의 경우 lpOpen 매개 변수는 MCI_OVLY_OPEN_PARMS 구조를 가리킵니다.

다음 추가 플래그는 waveaudio 디바이스 유형과 함께 사용됩니다.

MCI_WAVE_OPEN_BUFFER

버퍼 길이는 lpOpen으로 식별된 구조체의 dwBufferSeconds 멤버에 지정됩니다.

파형 오디오 디바이스의 경우 lpOpen 매개 변수는 MCI_WAVE_OPEN_PARMS 구조를 가리킵니다. MCIWAVE 드라이버에는 비동기 파형 오디오 디바이스가 필요합니다.

요구 사항

추가 정보

Mci

MCI 명령