IMFASFIndexer::GetCompletedIndex-Methode (wmcontainer.h)
Ruft den abgeschlossenen Index aus dem ASF-Indexerobjekt ab.
Syntax
HRESULT GetCompletedIndex(
[in] IMFMediaBuffer *pIIndexBuffer,
[in] QWORD cbOffsetWithinIndex
);
Parameter
[in] pIIndexBuffer
Zeiger auf die IMFMediaBuffer-Schnittstelle eines Medienpuffers, der die Indexdaten empfängt.
[in] cbOffsetWithinIndex
Der Offset der abzurufenden Daten in Bytes vom Anfang der Indexdaten. Legen Sie für den ersten Aufruf auf 0 fest. Wenn nachfolgende Aufrufe erforderlich sind (der Puffer ist nicht groß genug, um den gesamten Index zu enthalten), legen Sie auf das Byte nach dem letzten abgerufenen fest.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der Index wurde vor dem Versuch, den abgeschlossenen Index abzurufen, nicht committet. Weitere Informationen finden Sie in den Hinweisen. |
Hinweise
Diese Methode verwendet so viel Puffer wie möglich und aktualisiert die Länge des Puffers entsprechend.
Wenn pIIndexBuffer groß genug ist, um den gesamten Puffer zu enthalten, sollte cbOffsetWithinIndex 0 sein, und der Aufruf muss nur einmal erfolgen. Andernfalls sollte es keine Lücken zwischen aufeinanderfolgenden Puffern geben.
Der Benutzer muss diese Daten nach dem Ende des ASF-Datenobjekts in cbOffsetFromIndexStart-Bytes in den Inhalt schreiben. Sie können IMFASFIndexer::GetIndexPosition aufrufen, um die Startposition des ASF-Index zu bestimmen.
Dieser Aufruf ist nur erfolgreich, wenn IMFASFIndexer::CommitIndex aufgerufen wurde. Nach dem Aufruf von GetCompletedIndex muss der Aufrufer IMFASFContentInfo::GenerateHeader aufrufen und den vorhandenen ASF-Header mit dem neuen Header überschreiben. Andernfalls stimmt der ASF-Header nicht mit dem Inhalt überein, und die Datei wird nicht ordnungsgemäß wiedergegeben.
Sie können diese Methode nicht in einem Indexleseszenario verwenden. Sie können diese Methode nur beim Schreiben von Indizes verwenden.
Beispiele
Das folgende Beispiel zeigt, wie Sie den vollständigen ASF-Index in einen Bytedatenstrom schreiben.
HRESULT WriteASFIndex(IMFASFIndexer *pIndex,IMFByteStream *pStream)
{
const DWORD cbChunkSize = 4096;
IMFMediaBuffer *pBuffer = NULL;
QWORD cbIndex = 0;
DWORD cbIndexWritten = 0;
HRESULT hr = pIndex->GetIndexWriteSpace(&cbIndex);
if (FAILED(hr))
{
goto done;
}
hr = MFCreateMemoryBuffer(cbChunkSize, &pBuffer);
if (FAILED(hr))
{
goto done;
}
while (cbIndexWritten < cbIndex)
{
BYTE *pData = NULL;
DWORD cbData = 0;
DWORD cbWritten = 0;
hr = pIndex->GetCompletedIndex(pBuffer, cbIndexWritten);
if (FAILED(hr))
{
goto done;
}
hr = pBuffer->Lock(&pData, NULL, &cbData);
if (FAILED(hr))
{
goto done;
}
hr = pStream->Write(pData, cbData, &cbWritten);
(void)pBuffer->Unlock();
if (FAILED(hr))
{
goto done;
}
cbIndexWritten += cbData;
}
done:
SafeRelease(&pBuffer);
return hr;
};
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wmcontainer.h |
| Bibliothek | Mfuuid.lib |