IAMDevMemoryControl::GetDevId method (strmif.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note  The IAMDevMemoryControl interface is deprecated.
 
Retrieves the device ID of the on-board memory allocator.

Syntax

HRESULT GetDevId(
  [out] DWORD *pdwDevId
);

Parameters

[out] pdwDevId

Pointer to the device ID.

Return value

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

This method retrieves a unique ID that the hardware filter can use to verify that the specified allocator passed uses its on-board memory (because there can be more than one). The ID will be the same one as used to create the allocator object (using CoCreateInstance). For another filter to be able to use the on-board memory, it must have the same device ID as the on-board memory allocator.

Requirements

Requirement Value
Target Platform Windows
Header strmif.h (include Dshow.h)

See also

Error and Success Codes

IAMDevMemoryControl Interface