METODE IMFByteStream::Read (mfobjects.h)

Artikel
03/15/2023

Membaca data dari aliran.

Sintaks

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

Parameter

[in] pb

Penunjuk ke buffer yang menerima data. Pemanggil harus mengalokasikan buffer.

[in] cb

Ukuran buffer dalam byte.

[out] pcbRead

Menerima jumlah byte yang disalin ke dalam buffer. Parameter ini tidak boleh NULL.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini membaca paling banyak byte cb dari posisi saat ini di aliran dan menyalinnya ke dalam buffer yang disediakan oleh pemanggil. Jumlah byte yang dibaca dikembalikan dalam parameter pcbRead . Metode ini tidak mengembalikan kode kesalahan pada mencapai akhir file, sehingga aplikasi harus memeriksa nilai dalam pcbRead setelah metode kembali.

Metode ini sinkron. Ini memblokir sampai operasi baca selesai.

Catatan implementasi:Metode ini harus memperbarui posisi saat ini di aliran dengan menambahkan jumlah byte yang dibaca, yang ditentukan oleh nilai yang dikembalikan dalam parameter pcbRead , ke posisi saat ini. Metode lain yang dapat memperbarui posisi saat ini adalah Read, Write, BeginWrite, Seek, dan SetCurrentPosition.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Contoh

Contoh berikut membaca data dari aliran byte ke buffer media yang dialokasikan penelepon. Untuk informasi selengkapnya tentang buffer media, lihat Buffer Media.

// 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;
}

Contoh berikutnya serupa, tetapi mengalokasikan buffer media baru untuk menyimpan data.

Catatan Contoh ini menggunakan fungsi SafeRelease untuk merilis pointer antarmuka.

//-------------------------------------------------------------------
// 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;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfobjects.h (termasuk Mfidl.h)
Pustaka	Mfuuid.lib

Lihat juga

IMFByteStream

Share via