Share via

IMSVidDevice::get_Category Method

  • Article

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.

See Also

IMSVidDevice Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008