共用方式為

建置 DirectShow 篩選

  • 發行項

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

建議使用 DirectShow 基類來實作 DirectShow 篩選。 若要使用基類進行建置，除了 設定建置環境中所列的步驟之外，還要執行下列步驟：

  • 建置基類庫，位於 SDK 根目錄下的 Samples\Multimedia\DirectShow\BaseClasses 目錄。 連結庫有兩個版本：零售版（Strmbase.lib）和偵錯版本（Strmbasd.lib）。
  • 包含頭檔 Streams.h。
  • 使用__stdcall呼叫慣例。
  • 根據需要使用多執行緒的 C 執行期函式庫（偵錯，或零售）。
  • 包含導出 DLL 函式的定義 （.def） 檔案。 以下是定義檔的範例。 它會假設輸出檔名為 MyFilter.dll。
LIBRARY MYFILTER.DLL
EXPORTS 
    DllMain             PRIVATE
    DllGetClassObject   PRIVATE
    DllCanUnloadNow     PRIVATE
    DllRegisterServer   PRIVATE
    DllUnregisterServer PRIVATE
  • 連結至下列 lib 檔案。
標籤 價值
偵錯組建 Strmbasd.lib、Msvcrtd.lib、Winmm.lib
零售版本 Strmbase.lib、Msvcrt.lib、Winmm.lib
  • 在連結器設定中選擇 [忽略默認連結庫] 選項。
  • 在原始碼中宣告 DLL 進入點，如下所示：
extern "C" BOOL WINAPI DllEntryPoint(HINSTANCE, ULONG, LPVOID);
BOOL APIENTRY DllMain(HANDLE hModule, DWORD dwReason, LPVOID lpReserved)
{
    return DllEntryPoint((HINSTANCE)(hModule), dwReason, lpReserved);
}

舊版

針對 DirectShow 9.0 之前的基類連結庫版本，您也必須執行下列動作：

  • 針對偵錯組建，請定義預處理器旗標 DEBUG。

DirectShow 9.0 和更新版本中提供的基類連結庫版本不需要此步驟。

DirectShow 基礎類別

撰寫 DirectShow 濾鏡