IXAPO::QueryInterface method

Retrieves the requested interface pointer if the XAPO supports it.

Syntax

HRESULT QueryInterface(
   RFFIID riid,
   void   **ppv
);

Parameters

  • riid
    The requested interface ID. For the IXAPO interface this will be __uuidof(IXAPO), for the IXAPOParameters interface this will be __uuidof(IXAPOParameters).

  • ppv
    If the requested interface is supported ppv will be set to a pointer to the interface and the object's reference count will be incremented by 1.

Return value

Returns S_OK if the interface is supported; otherwise returns E_NOINTERFACE.

Remarks

XAPO instances are passed to XAudio2 as IUnknown interfaces and XAudio2 uses QueryInterface to acquire an IXAPO interface and to detect whether the XAPO implements the IXAPOParameters interface. Implementations of IXAPO must accept requests for __uuidof(IXAPO) and if IXAPOParameters is implemented must also accept requests for __uuidof(IXAPOParameters).

Platform Requirements

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements

Header

XAPO.h

See also

IXAPO