Windows Media Format SDK banner art
PreviousNext

IMDSPObjectInfo::GetTotalLength

The GetTotalLength method retrieves the total play length of the object in units pertinent to the object. The value returned is the total length regardless of the current settings of the play length and offset.

Syntax

HRESULT GetTotalLength(
  DWORD*  pdwLength
);

Parameters

  pdwLength

[out]  Pointer to a double word containing the total length of the object, in units pertinent to the object.

Return Values

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

Return code Description
E_INVALIDTYPE The object that this interface is associated with is not a valid playable file or a folder or file system containing playable files.
WMDM_E_NOTSUPPORTED This object cannot report total play length.
E_FAIL An unspecified error occurred.

Remarks

The value returned in the pdwLength parameter is the total length of the object regardless of the current settings of the play length and play offsets.

For playable files, the total length is specified in milliseconds.

For folders or file systems containing playable files, the value returned indicates the total number of playable files in a folder or in the root of a file system.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.