Share via


IMSVidDevice::get_Category method (segment.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The get_Category method retrieves the category of the device as a BSTR.

Syntax

HRESULT get_Category(
  [out] BSTR *Guid
);

Parameters

[out] Guid

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

Requirement Value
Minimum supported client Windows�XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header segment.h (include Msvidctl.h)

See also

IMSVidDevice Interface