Windows Media Format SDK banner art
PreviousNext

IWMInputMediaProps::GetConnectionName

The GetName method retrieves the connection name specified in the profile.

Syntax

HRESULT GetConnectionName(
  WCHAR*  pwszName,
  WORD*  pcchName
);

Parameters

  pwszName

[out]  Pointer to a wide-character NULL-terminated string containing the connection name.

  pcchName

[in, out]  On input, specifies a pointer to a variable containing the length of the pwszName array in wide characters (two bytes). On output, and if the method succeeds, the variable contains the actual length of the name.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Meaning
E_INVALIDARG The pcchName parameter is NULL.
ASF_E_BUFFERTOOSMALL The pwszName parameter is not large enough.

Remarks

The connection name should be matched with the input name set on one (or more) of the streams in the profile.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.