共用方式為

IAMStreamConfig：：GetStreamCaps 方法 (strmif.h)

  • 發行項

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

GetStreamCaps 方法會擷取一組格式功能。

語法

HRESULT GetStreamCaps(
  [in]  int           iIndex,
  [out] AM_MEDIA_TYPE **ppmt,
  [out] BYTE          *pSCC
);

參數

[in] iIndex

指定要從零擷取、編製索引的格式功能。 若要判斷針腳支援的功能數目，請呼叫 IAMStreamConfig：：GetNumberOfCapabilities 方法。

[out] ppmt

AM_MEDIA_TYPE 結構的指標位址。 方法會配置 結構，並將它填入媒體類型。

[out] pSCC

呼叫端所配置的位元組陣列指標。 如需影片，請使用 VIDEO_STREAM_CONFIG_CAPS 結構 (請參閱) 。 針對音訊，請使用 AUDIO_STREAM_CONFIG_CAPS 結構。 若要判斷陣列的必要大小，請呼叫 GetNumberOfCapabilities 方法。 大小會在 piSize 參數中傳回。

傳回值

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

傳回碼 Description
S_FALSE
 指定的索引太高。
S_OK
 成功。
E_INVALIDARG
 索引無效。
E_OUTOFMEMORY
 記憶體不足。
E_POINTER
 NULL 指標值。
VFW_E_NOT_CONNECTED
 輸入針腳未連接。

備註

此方法會傳回兩項資訊：

注意 使用 VIDEO_STREAM_CONFIG_CAPS 結構來設定影片裝置已被取代。 雖然呼叫端必須配置緩衝區，但應該忽略方法傳回之後的內容。 擷取裝置會透過 pmt 參數傳回其支援的格式。
 
若要設定輸出針腳，使其使用此格式，請呼叫 IAMStreamConfig：：SetFormat 方法，並傳入 pmt 的值。

呼叫 SetFormat 之前，您可以使用 pSCC 中的資訊，在 pmt 中修改AM_MEDIA_TYPE結構。 例如，音訊針腳可能會在 pmt 參數中傳回預設媒體類型 44-kHz、16 位的立體聲。 根據 AUDIO_STREAM_CONFIG_CAPS 結構中所傳回的值，您可以在呼叫 SetFormat 之前，將此格式變更為 8 位 mono。

方法會為 pmt 參數中傳回的 AM_MEDIA_TYPE 結構配置記憶體。 呼叫端必須釋放記憶體，包括格式區塊。 您可以在基類連結庫中使用 DeleteMediaType 協助程式函式。 呼叫端必須配置 pSCC 參數的記憶體。

在某些壓縮篩選條件上，如果篩選條件的輸入針腳未連線，這個方法就會失敗。

篩選開發人員：如需實作此方法的詳細資訊，請參閱 公開擷取和壓縮格式。

範例

下列範例會擷取影片輸出釘選上第一個支援的格式 (索引零) ，然後在釘選上設定此格式。

C++ 
int iCount， iSize;BYTE *pSCC = NULL;AM_MEDIA_TYPE *pmt;
hr = pConfig-GetNumberOfCapabilities> (&iCount，&iSize) ;


pSCC = 新的 BYTE[iSize];如果 (pSCC == NULL) { = TODO：記憶體不足錯誤。
}


// Get the first format.
hr = pConfig->GetStreamCaps(0, &pmt, pSCC));
if (hr == S_OK)
{
// TODO: Examine the format. If it's not suitable for some
// reason, call GetStreamCaps with the next index value (up
// to iCount). Otherwise, set the format:
hr = pConfig->SetFormat(pmt);
if (FAILED(hr))
{
// TODO: Error handling.
}
DeleteMediaType(pmt);
}
delete [] pSCC;

規格需求

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

另請參閱

錯誤和成功碼

IAMStreamConfig 介面