Skip to content

Latest commit

 

History

History
82 lines (63 loc) · 3.44 KB

nf-strmif-iamresourcecontrol-reserve.md

File metadata and controls

82 lines (63 loc) · 3.44 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:strmif.IAMResourceControl.Reserve
IAMResourceControl::Reserve (strmif.h)
The Reserve method reserves or unreserves a device resource.
IAMResourceControl interface [DirectShow]
Reserve method
IAMResourceControl.Reserve
IAMResourceControl::Reserve
IAMResourceControlReserve
Reserve
Reserve method [DirectShow]
Reserve method [DirectShow]
IAMResourceControl interface
dshow.iamresourcecontrol_reserve
strmif/IAMResourceControl::Reserve
dshow\iamresourcecontrol_reserve.htm
dshow
5f264b87-dae4-4478-811f-1c99e670928a
4/26/2023
IAMResourceControl interface [DirectShow],Reserve method, IAMResourceControl.Reserve, IAMResourceControl::Reserve, IAMResourceControlReserve, Reserve, Reserve method [DirectShow], Reserve method [DirectShow],IAMResourceControl interface, dshow.iamresourcecontrol_reserve, strmif/IAMResourceControl::Reserve
strmif.h
Dshow.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Strmiids.lib
Windows
19H1
IAMResourceControl::Reserve
strmif/IAMResourceControl::Reserve
c++
APIRef
kbSyntax
COM
Strmiids.lib
Strmiids.dll
IAMResourceControl.Reserve

IAMResourceControl::Reserve

-description

[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 Reserve method reserves or unreserves a device resource.

-parameters

-param dwFlags [in]

Flag indicating whether to reserve or unreserve this device. The value must be a member of the AMRESCTL_RESERVEFLAGS enumeration.

-param pvReserved [in]

Must be NULL.

-returns

Returns S_OK if the device was successfully reserved or unreserved, S_FALSE if the device is currently reserved and will continue to be held, or an HRESULT error code if the device can't be reserved.

-remarks

A resource can be reserved multiple times. If the method returns S_OK, the filter increments an internal reserve count. For every call to reserve a device that returns S_OK, the caller must make a matching call to unreserve the device.

-see-also

Error and Success Codes

IAMResourceControl Interface