iAsyncReader：：Request 方法 (strmif.h)

  • 發行項

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]

方法會將 Request 數據的異步要求排入佇列。

語法

HRESULT Request(
       IMediaSample *pSample,
  [in] DWORD_PTR    dwUser
);

參數

pSample

呼叫端所提供之媒體範例 之 IMediaSample 介面的指標。

[in] dwUser

指定要求完成時傳回的任意值。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 描述
S_OK
 成功。
VFW_E_BADALIGN
 緩衝區未正確對齊。
VFW_E_SAMPLE_TIME_NOT_SET
 此範例未加時間戳。
VFW_E_WRONG_STATE
 針腳正在排清。
HRESULT_FROM_WIN32 (ERROR_HANDLE_EOF)
要求的開始位置超過檔案的結尾。
E_OUTOFMEMORY
 記憶體不足。

備註

呼叫這個方法之前，請先從針腳的配置器擷取媒體範例。 時間戳您要求的位元組位移範例，第一個和最後一個包含，乘以10,000,000。 位元組位移相對於數據流的開頭。

開始和停止位置應該符合接腳連接時所決定的對齊方式。 否則，方法可能會傳回VFW_E_BADALIGN。 如果同意的對齊方式比數據流的實際對齊方式更粗略，則停止位置可能會超過實際持續時間。 如果是，此方法會將停止位置向下四捨五入為實際的對齊方式。

雖然在技術上違反 COM 規則，但呼叫端必須保留樣本的未處理參考計數。 方法 Request 不會呼叫 AddRef 或 Release，因此需要參考計數才能讓樣本保持作用中。

方法會在要求完成之前傳回。 呼叫 IAsyncReader：：WaitForNext 方法來等候要求。 當要求擱置時，請勿重複使用原始媒體範例。 WaitForNext 方法會傳回原始範例的指標。 如果要求成功，此範例會包含要求的數據。 WaitForNext 方法也會傳回 dwUser 參數中指定的任何值。 呼叫端可以使用此值來識別範例。

範例

下列範例顯示輸入針腳的可能協助程式函式，以將要求排入佇列：

C++ 
CMyPin::QueueSample(long cbFirst, long cbLast, DWORD_PTR dwuser)
{
    IMediaSample* pSample = NULL;
    HRESULT hr = m_pAlloc->GetBuffer(&pSample, NULL, NULL, 0);
    if (FAILED(hr)) 
    { 
        return hr; 
    }

    LONGLONG tStart = cbFirst * 10000000, tStop = cbLast * 10000000;
    hr = pSample->SetTime(&tStart, &tStop);
    if (SUCCEEDED(hr))
    {
        hr = m_pReader->Request(pSample, dwuser);
    }

    if (FAILED(hr))
    {
        pSample->Release();
    }
    return hr;
}

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IAsyncReader 介面