IMFByteStream::Read-Methode (mfobjects.h)

Artikel
02/28/2024

Liest Daten aus dem Stream.

Syntax

HRESULT Read(
  [in]  BYTE  *pb,
  [in]  ULONG cb,
  [out] ULONG *pcbRead
);

Parameter

[in] pb

Zeiger auf einen Puffer, der die Daten empfängt. Der Aufrufer muss den Puffer zuordnen.

[in] cb

Größe des Puffers in Byte.

[out] pcbRead

Empfängt die Anzahl der Bytes, die in den Puffer kopiert werden. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode liest höchstens cb Bytes von der aktuellen Position im Stream und kopiert sie in den vom Aufrufer bereitgestellten Puffer. Die Anzahl der gelesenen Bytes wird im pcbRead-Parameter zurückgegeben. Die -Methode gibt keinen Fehlercode zurück, wenn das Ende der Datei erreicht wird. Daher sollte die Anwendung den Wert in pcbRead überprüfen, nachdem die Methode zurückgegeben wurde.

Diese Methode ist synchron. Er wird blockiert, bis der Lesevorgang abgeschlossen ist.

Implementierungshinweise:Diese Methode sollte die aktuelle Position im Stream aktualisieren, indem die Anzahl der gelesenen Bytes, die durch den im parameter pcbRead zurückgegebenen Wert angegeben wird, zur aktuellen Position hinzugefügt wird. Weitere Methoden, die die aktuelle Position aktualisieren können, sind Read, Write, BeginWrite, Seek und SetCurrentPosition.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

Windows XP mit Service Pack 2 (SP2) und höher.
Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Beispiele

Im folgenden Beispiel werden Daten aus einem Bytestream in einen vom Aufrufer zugewiesenen Medienpuffer gelesen. Weitere Informationen zu Medienpuffern finden Sie unter Medienpuffer.

// Read data from a byte stream into a media buffer.
//
// This function reads a maximum of cbMax bytes, or up to the size of the 
// buffer, whichever is smaller. If the end of the byte stream is reached, the 
// actual amount of data read might be less than either of these values.
//
// To find out how much data was read, call IMFMediaBuffer::GetCurrentLength.

HRESULT ReadFromByteStream(
    IMFByteStream *pStream,     // Pointer to the byte stream.
    IMFMediaBuffer *pBuffer,    // Pointer to the media buffer.
    DWORD cbMax                 // Maximum amount to read.
    )
{
    DWORD cbBufferMax = 0;
    DWORD cbRead = 0;
    BYTE *pData= NULL;

    HRESULT hr = pBuffer->Lock(&pData, &cbBufferMax, NULL);

    // Do not exceed the maximum size of the buffer.
    if (SUCCEEDED(hr))
    {
        if (cbMax > cbBufferMax)
        {
            cbMax = cbBufferMax;
        }

        // Read up to cbMax bytes.
        hr = pStream->Read(pData, cbMax, &cbRead);
    }

    // Update the size of the valid data in the buffer.
    if (SUCCEEDED(hr))
    {
        hr = pBuffer->SetCurrentLength(cbRead);
    }
    if (pData)
    {
        pBuffer->Unlock();
    }
    return hr;
}

Das nächste Beispiel ist ähnlich, weist jedoch einen neuen Medienpuffer zu, der die Daten enthält.

Hinweis In diesem Beispiel wird die SafeRelease-Funktion verwendet, um Schnittstellenzeiger freizugeben.

//-------------------------------------------------------------------
// AllocReadFromByteStream
//
// Reads data from a byte stream and returns a media buffer that
// contains the data.
//-------------------------------------------------------------------

HRESULT AllocReadFromByteStream(
    IMFByteStream *pStream,         // Pointer to the byte stream.
    DWORD cbToRead,                 // Number of bytes to read.
    IMFMediaBuffer **ppBuffer       // Receives a pointer to the media buffer. 
    )
{
    HRESULT hr = S_OK;
    BYTE *pData = NULL;
    DWORD cbRead = 0;   // Actual amount of data read.

    IMFMediaBuffer *pBuffer = NULL;

    // Create the media buffer. 
    // This function allocates the memory for the buffer.
    hr = MFCreateMemoryBuffer(cbToRead, &pBuffer);

    // Get a pointer to the memory buffer.
    if (SUCCEEDED(hr))
    {
        hr = pBuffer->Lock(&pData, NULL, NULL);
    }

    // Read the data from the byte stream.
    if (SUCCEEDED(hr))
    {
        hr = pStream->Read(pData, cbToRead, &cbRead);
    }

    // Update the size of the valid data in the buffer.
    if (SUCCEEDED(hr))
    {
        hr = pBuffer->SetCurrentLength(cbRead);
    }

    // Return the pointer to the caller.
    if (SUCCEEDED(hr))
    {
        *ppBuffer = pBuffer;
        (*ppBuffer)->AddRef();
    }

    if (pData)
    {
        pBuffer->Unlock();
    }
    SafeRelease(&pBuffer);
    return hr;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfobjects.h (include Mfidl.h)
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFByteStream

Freigeben über