IMFAsyncResult::GetObject 메서드(mfobjects.h)

비동기 작업과 연결된 개체를 반환합니다. 개체의 형식(있는 경우)은 호출된 비동기 메서드에 따라 달라집니다.

구문

HRESULT GetObject(
  [out] IUnknown **ppObject
);

[out] ppObject

개체의 IUnknown 인터페이스에 대한 포인터를 받습니다. 작업과 연결된 개체가 없으면 이 매개 변수는 NULL 값을 받습니다. 값이 NULL이 아닌 경우 호출자는 인터페이스를 해제해야 합니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	이 비동기 결과와 연결된 개체가 없습니다.

일반적으로 이 개체는 비동기 메서드를 구현하는 구성 요소에서 사용됩니다. 콜백을 호출하여 작업을 완료하는 비동기 End... 메서드에 정보를 전달하는 함수에 대한 방법을 제공합니다.

비동기 메서드를 구현하는 경우 MFCreateAsyncResult 함수의 punkObject 매개 변수를 통해 개체를 설정할 수 있습니다.

비동기 결과 개체의 내부 IUnknown 포인터가 NULL이면 메서드는 E_POINTER 반환합니다.

이 인터페이스는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

Windows XP SP2(서비스 팩 2) 이상
KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)가 설치된 Windows XP Media Center Edition 2005.