DirectMusic DirectMusic C/C++ 레퍼런스 DirectMusic 의 인터페이스   [목차열람] [주소복사] [슬롯비우기]

DirectMusic 의 인터페이스

여기에서는, DirectMusic 의 COM 인터페이스의 레퍼런스에 대해 기술한다.

현재의 버전의 인터페이스 (IKsControl 와 IReferenceClock 를 제외한다)는, 이름의 마지막에 8 을 붙여, 선언 또는 정의한다. 최신 버전의 인터페이스를 확실히 사용하려면 , 인터페이스 포인터의 선언시에 이 접미어를 반드시 붙인다.

메서드가 얻어온다 인터페이스는, 항상 기본 버전이다. 보다 새로운 버전이 존재하는 경우는, 다음과 같이QueryInterface 를 호출해 그것을 얻어올 필요가 있다. lpdmBand 는,IDirectMusicBand8 인터페이스 포인터이다.

IDirectMusicSegment * lpdmseg;
IDirectMusicSegment8 * lpdmseg8;
 
HRESULT hr = lpdmBand->CreateSegment(&lpdmseg);
if (SUCCEEDED(hr)) 
{
  hr = lpdmseg->QueryInterface(IID_IDirectMusicSegment8, 
    (LPVOID*) &lpdmseg8);
}

인터페이스의 새로운 버전이 없는 경우, 접미어 8 이 붙은 인터페이스명은 정의뿐이다. 예를 들어,IDirectMusicGraph8 는, 모든 점으로써 IDirectMusicGraph 와 동일하다. 이러한 경우, 새로운 인터페이스를 문의할 필요는 없지만, 문의를 하는 것은, 아무해도 없을 뿐만 아니라, DirectX 의 장래의 버전에 대비해 코드의 보수성을 높이는데 도움이 된다.

구버전의 인터페이스로 지원 되고 있는 메서드의 정보에 대해서는, 해당하는 헤더 파일의 인터페이스의 선언을 참조할것.

IN (입력) 파라미터로서 인터페이스 포인터를 건네줄 수가 있는 경우는, 낡은 버전을 받아들이도록(듯이) 메서드가 선언되고 있어도, 새로운 버전을 건네줄 수가 있다. 예를 들어,IDirectMusicPerformance8::PlaySegmentEx 에는,IDirectMusicSegment 또는 IDirectMusicSegment8 에의 포인터를 건네줄 수가 있다.

이 문서는, 인터페이스의 최신 버전으로 한정한, 완전한 레퍼런스 주제를 수록하고 있다. IDirectMusicGraph8 와 같은 정의가 존재하는 경우, 인터페이스는 그 이름으로 기재되어 있다.