IMixerPinConfig::SetZOrder method (mpconfig.h)

Article
02/22/2024

[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.]

The SetZOrder method sets the z-order of a particular video stream.

This method is not currently implemented and returns E_NOTIMPL.

Syntax

HRESULT SetZOrder(
  [in] DWORD dwZOrder
);

Parameters

[in] dwZOrder

Value indicating the order in which streams will clip each other.

Return value

Returns E_NOTIMPL.

Remarks

The z-order indicates which streams can clip other streams. Images with larger z-values are always in front of images with smaller z-values.

The relative order of multiple streams is significant only if the video images overlap.

Specifying the same z-order for two overlapping streams can cause strange video artifacts.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	mpconfig.h
Library	Strmiids.lib