Edit

Share via

IActivateAudioInterfaceAsyncOperation::GetActivateResult method (mmdeviceapi.h)

  • Article

Gets the results of an asynchronous activation of a WASAPI interface initiated by an application calling the ActivateAudioInterfaceAsync function.

Syntax

HRESULT GetActivateResult(
  [out] HRESULT  *activateResult,
  [out] IUnknown **activatedInterface
);

Parameters

[out] activateResult

[out] activatedInterface

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
E_ILLEGAL_METHOD_CALL
 The method was called before the asynchronous operation was complete.

Remarks

An application calls this method after Windows calls the ActivateCompleted method of the application’s IActivateAudioInterfaceCompletionHandler interface.

The result code returned through activateResult may depend on the requested interface. For additional information, see IMMDevice::Activate. A result code of E_ACCESSDENIED might indicate that the user has not given consent to access the device in a manner required by the requested WASAPI interface.

The returned activatedInterface may be NULL if activateResult is not a success code.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header mmdeviceapi.h

See also

ActivateAudioInterfaceAsync

IActivateAudioInterfaceAsyncOperation