IMSVidDevice::get_Category Method

2009-01-07

This topic applies to Windows XP or later.
The get_Category method retrieves the category of the device as a BSTR.

Syntax

HRESULT get_Category(
  [out]  BSTR *pGuid
);

Parameters

pGuid [out]
BSTR that receives the device category.

Return Value

Returns an HRESULT value. Possible values include the following.

Return code	Description
S_OK	Success.
E_POINTER	NULL pointer argument.

Remarks

The device category is identified by a GUID. This method returns a string representation of the GUID.

This method is provided for Automation clients. C++ applications can use the IMSVidDevice::get__Category method, which returns a GUID rather than a BSTR.

The caller must free the returned string, using the SysFreeString function.

Requirements

Header	Declared in Dshow.h.
DLL	Requires Quartz.dll.

Share via