Edit

Share via

IMFCaptureSink::GetService method (mfcaptureengine.h)

  • Article

Queries the underlying Sink Writer object for an interface.

Syntax

HRESULT GetService(
  [in]  DWORD    dwSinkStreamIndex,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnknown
);

Parameters

[in] dwSinkStreamIndex

The zero-based index of the stream to query. The index is returned in the pdwSinkStreamIndex parameter of the IMFCaptureSink::AddStream method.

[in] rguidService

A service identifier GUID. Currently, the value must be GUID_NULL.

[in] riid

A service identifier GUID. Currently, the value must be IID_IMFSinkWriter.

[out] ppUnknown

Receives a pointer to the IUnknown interface. The caller must release the interface.

Return value

This method can return one of these values.

Return code Description
S_OK
 Success.
E_INVALIDARG
 Invalid argument.
MF_E_INVALIDREQUEST
 Invalid request.
MF_E_INVALIDSTREAMNUMBER
 Invalid stream number.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header mfcaptureengine.h

See also

IMFCaptureSink