ITocEntry::GetSubEntries-Methode (wmcodecdsp.h)

  • Artikel

Die GetSubEntries-Methode ruft ein Array von Untereintragsindizes ab, die durch einen vorherigen Aufruf von SetSubEntries festgelegt wurden.

Syntax

HRESULT GetSubEntries(
  [in, out] DWORD *pdwNumSubEntries,
  [out]     WORD  *pwSubEntryIndices
);

Parameter

[in, out] pdwNumSubEntries

Wenn pwSubEntryIndicesNULL ist, ist dies ein Ausgabeparameter, der die Anzahl von Untereinträgen empfängt, die diesem Eintrag zugeordnet sind. Wenn pwSubEntryIndices nicht NULL ist, ist dies ein Eingabeparameter, der die Anzahl von DWORD-Wertenim aufruferseitig zugewiesenen Array angibt, auf das von pwSubEntryIndices verwiesen wird.

[out] pwSubEntryIndices

NULL oder ein Zeiger auf ein aufruferseitig zugeordnetes Array von DWORDs, das die Untereintragsindizes empfängt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_BUFFERTOOSMALL
 Die -Methode gibt diesen Fehlercode zurück, wenn pwSubEntryIndices nicht NULL ist und die Anzahl der Untervorgänge größer ist als die von pdwNumSubEntries angegebene Zahl. In diesem Fall dient pdwNumSubEntries als Ausgabeparameter und empfängt die Anzahl der verfügbaren Untereintragsindizes.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wmcodecdsp.h
DLL Wmvdspa.dll

Weitere Informationen

ITocEntry

SetSubEntries