CMediaEvent.Invoke 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다.

구문

HRESULT Invoke(
   DISPID     dispidMember,
   REFIID     riid,
   LCID       lcid,
   WORD       wFlags,
   DISPPARAMS *pdispparams,
   VARIANT    *pvarResult,
   EXCEPINFO  *pexcepinfo,
   UINT       *puArgErr
);

매개 변수

dispidMember

멤버의 식별자입니다. CMediaEvent::GetIDsOfNames 또는 개체의 설명서를 사용하여 디스패치 식별자를 가져옵니다.

riid

다음에 사용하도록 예약됩니다. IID_NULL이어야 합니다.

lcid

인수를 해석할 로캘 컨텍스트입니다.

wFlags

호출의 컨텍스트를 설명하는 플래그입니다 CMediaEvent::Invoke .

pdispparams

인수 배열, 명명된 인수에 대한 인수 디스패치 ID 배열 및 배열의 요소 수에 대한 개수를 포함하는 구조체에 대한 포인터입니다.

pvarResult

결과를 저장할 위치에 대한 포인터이거나 호출자에게 결과가 필요하지 않은 경우 NULL 입니다.

pexcepinfo

예외 정보를 포함하는 구조체에 대한 포인터입니다.

puArgErr

오류가 있는 DISPPARAMS 구조체의 rgvarg 배열 내에서 첫 번째 인수의 인덱스에 대한 포인터입니다. DISPPARAMS에 대한 자세한 내용은 플랫폼 SDK를 참조하세요.

반환 값

riid가 IID_NULL 않으면 DISP_E_UNKNOWNINTERFACE 반환합니다. 호출이 실패하면 CMediaEvent::GetTypeInfo 의 오류 코드 중 하나를 반환합니다. 그렇지 않으면 는 IDispatch::Invoke 호출에서 HRESULT를 반환합니다.

요구 사항

요구 사항	값
헤더	Ctlutil.h(Streams.h 포함)
라이브러리	Strmbase.lib(소매 빌드); Strmbasd.lib(디버그 빌드)

추가 정보

CMediaEvent 클래스