Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method sets a property identified by a property set GUID and a property ID.

Syntax

HRESULT Set(
  REFGUID 
guidPropSet,
  DWORD   
dwPropID,
  LPVOID  
pInstanceData,
  DWORD   
cbInstanceData,
  LPVOID  
pPropData,
  DWORD   
cbPropData
);

Parameters

guidPropSet

[in] A REFGUID value that contains the property set GUID.

dwPropID

[in] A DWORD value that identifies the property within the property set.

pInstanceData

[out] An LPVOID value that is a pointer to instance data for the property. The size of the data is cbInstanceData.

cbInstanceData

[in] A DWORD value that identifies the number of bytes in the buffer to which pInstanceDatapoints.

pPropData

[out] An LPVOID value that is a pointer to the retrieved buffer, which contains the value of the property. The size of the buffer is cbPropData.

cbPropData

[in] A DWORD value that identifies the number of bytes in the buffer to which pPropDatapoints.

Return Value

Returns an HRESULT value. The following table shows some of the possible return values.

Value Description

S_OK

Success.

E_PROP_SET_UNSUPPORTED

The property set is not supported.

E_PROP_ID_UNSUPPORTED

The property ID is not supported for the specified property set.

Remarks

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

Requirements

Windows Embedded CE Windows CE 5.0 Networked Media Device Feature Pack and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment

See Also