mfapi.h 標頭

此標頭由多個技術使用。 如需詳細資訊，請參閱：

• Microsoft媒體基金會
• 串流媒體 DDI 參考

mfapi.h 包含下列程序設計介面：

功能

DEFINE_MEDIATYPE_GUID 從 FOURCC 程式代碼、D3DFORMAT值或音訊格式類型定義媒體子類型 GUID。
MFAddPeriodicCallback 設定要以固定間隔呼叫的回呼函式。 （MFAddPeriodicCallback）
MFAllocateSerialWorkQueue 建立保證串行化工作專案的工作佇列。
MFAllocateWorkQueue 建立新的工作佇列。 （MFAllocateWorkQueue）
MFAllocateWorkQueueEx 建立新的工作佇列。 （MFAllocateWorkQueueEx）
MFAverageTimePerFrameToFrameRate 從視訊畫面的平均持續時間計算每秒畫面格的幀速率。
MFBeginCreateFile 開始異步要求，從檔案建立位元組數據流。
MFBeginRegisterWorkQueueWithMMCSS 將工作佇列與多媒體類別排程器服務 （MMCSS） 工作產生關聯。 （MFBeginRegisterWorkQueueWithMMCSS）
MFBeginRegisterWorkQueueWithMMCSSEx 將工作佇列與多媒體類別排程器服務 （MMCSS） 工作產生關聯。 （MFBeginRegisterWorkQueueWithMMCSSEx）
MFBeginUnregisterWorkQueueWithMMCSS 從多媒體類別排程器服務 （MMCSS） 工作取消註冊工作佇列。 （MFBeginUnregisterWorkQueueWithMMCSS）
MFCalculateBitmapImageSize 擷取視訊格式的影像大小。
MFCalculateImageSize 擷取未壓縮視訊格式的影像大小，以位元組為單位。 （MFCalculateImageSize）
MFCancelCreateFile 取消異步要求，以從檔案建立位元組數據流。
MFCancelWorkItem 嘗試取消以 MFScheduleWorkItem 或 MFScheduleWorkItemEx 排程的異步操作。
MFCombineSamples 如果媒體的合併持續時間未超過指定的持續時間，將媒體範例串連至另一個樣本。
MFCompareFullToPartialMediaType 比較完整媒體類型與部分媒體類型。
MFConvertColorInfoFromDXVA 設定 MFVIDEOFORMAT 結構中的擴充色彩資訊。
MFConvertColorInfoToDXVA 將延伸色彩資訊從 MFVIDEOFORMAT 轉換為相等的 DirectX 視訊加速 （DXVA） 色彩資訊。
MFConvertFromFP16Array 將16位浮點數的數位轉換成32位浮點數的陣列。
MFConvertToFP16Array 將32位浮點數的數位轉換成16位浮點數的陣列。
MFCopyImage 將影像或圖像平面從一個緩衝區複製到另一個緩衝區。
MFCreate2DMediaBuffer 建立系統記憶體緩衝區物件來保存 2D 映像數據。
MFCreateAlignedMemoryBuffer 使用指定的位元組對齊配置系統記憶體，並建立媒體緩衝區來管理記憶體。
MFCreateAMMediaTypeFromMFMediaType 從媒體基礎媒體類型建立 DirectShow AM_MEDIA_TYPE 結構。
MFCreateAsyncResult 建立異步結果物件。 如果您要實作異步方法，請使用此函式。 （MFCreateAsyncResult）
MFCreateAttributes 建立空的屬性存放區。
MFCreateAudioMediaType 從「超聲波」結構建立音訊媒體類型。
MFCreateCollection 建立空集合物件。
MFCreateDXGIDeviceManager 建立 Microsoft DirectX 圖形基礎結構 （DXGI） 裝置管理員 的實例。
MFCreateDXGISurfaceBuffer 建立媒體緩衝區來管理 Microsoft DirectX 圖形基礎結構 （DXGI） 介面。
MFCreateDXSurfaceBuffer 建立管理 Direct3D 9 介面的媒體緩衝區物件。
MFCreateEventQueue 建立事件佇列。
MFCreateFile 從檔案建立位元組數據流。
MFCreateLegacyMediaBufferOnMFMediaBuffer 將媒體基礎媒體緩衝區轉換成與 DirectX 媒體物件 （DMO） 相容的緩衝區。
MFCreateMediaBufferFromMediaType 配置最適合指定媒體類型的系統記憶體緩衝區。
MFCreateMediaBufferWrapper 建立包裝現有媒體緩衝區的媒體緩衝區。
MFCreateMediaEvent 建立媒體事件物件。
MFCreateMediaExtensionActivate 建立 Windows 執行階段 類別的啟用物件。
MFCreateMediaType 建立空的媒體類型。
MFCreateMediaTypeFromRepresentation 從其他格式表示建立媒體基礎媒體類型。
MFCreateMemoryBuffer 配置系統記憶體，並建立媒體緩衝區來管理它。
MFCreateMFByteStreamWrapper 建立位元組數據流的包裝函式。
MFCreateMFVideoFormatFromMFMediaType 從視訊媒體類型建立 MFVIDEOFORMAT 結構。
MFCreateMuxStreamAttributes 建立IMFAttributes，描述多任務處理子數據流的內容。
MFCreateMuxStreamMediaType 建立IMFMediaType，描述多任務處理子數據流的媒體類型。
MFCreateMuxStreamSample 建立包含多任務子數據流樣本的IMFSample。
MFCreateSample 建立空白媒體範例。
MFCreateTempFile 建立暫存本機檔案支援的位元組數據流。
MFCreateVideoMediaType 從 MFVIDEOFORMAT 結構建立視訊媒體類型。
MFCreateVideoMediaTypeFromBitMapInfoHeader 未實作此函式。 （MFCreateVideoMediaTypeFromBitMapInfoHeader）
MFCreateVideoMediaTypeFromBitMapInfoHeaderEx 從 BITMAPINFOHEADER 結構建立視訊媒體類型。
MFCreateVideoMediaTypeFromSubtype 使用指定的子類型建立部分視訊媒體類型。
MFCreateVideoMediaTypeFromVideoInfoHeader 從 KS_VIDEOINFOHEADER 結構建立媒體類型。
MFCreateVideoMediaTypeFromVideoInfoHeader2 從KS_VIDEOINFOHEADER2結構建立媒體類型。
MFCreateVideoSampleAllocatorEx 建立物件，此物件會配置與 Microsoft DirectX Graphics Infrastructure （DXGI） 相容的影片範例。
MFCreateWaveFormatExFromMFMediaType 將媒體基礎音訊媒體類型轉換成「超聲波」結構。
MFCreateWICBitmapBuffer 建立管理 Windows 映射元件 （WIC） 的媒體緩衝區物件。
MFEndCreateFile 完成異步要求，以從檔案建立位元組數據流。
MFEndRegisterWorkQueueWithMMCSS 完成異步要求，以將工作佇列與多媒體類別排程器服務 （MMCSS） 工作產生關聯。 （MFEndRegisterWorkQueueWithMMCSS）
MFEndUnregisterWorkQueueWithMMCSS 完成異步要求，從多媒體類別排程器服務 （MMCSS） 工作取消註冊工作佇列。
MFFrameRateToAverageTimePerFrame 將視訊幀速率轉換成畫面持續時間。
MFGetAttribute2UINT32asUINT64 取得屬性，其值為兩個封裝在 UINT64 中的 UINT32 值。
MFGetAttributeDouble 從屬性存放區傳回雙精度浮點數，如果屬性不存在，則傳回預設值。
MFGetAttributeRatio 擷取其值為比率的屬性。
MFGetAttributesAsBlob 將屬性存放區的內容轉換為位元組陣列。
MFGetAttributesAsBlobSize 擷取 MFGetAttributesAsBlob 函式所需的緩衝區大小。
MFGetAttributeSize 擷取其值為大小的屬性，以寬度和高度表示。
MFGetAttributeString 從屬性存放區取得字串值。
MFGetAttributeUINT32 從屬性存放區傳回 UINT32 值，如果屬性不存在，則傳回預設值。
MFGetAttributeUINT64 從屬性存放區傳回 UINT64 值，如果屬性不存在，則傳回預設值。
MFGetContentProtectionSystemCLSID 取得內容保護系統的類別識別碼。
MFGetMFTMerit 取得硬體編解碼器的優點值。
MFGetPlaneSize 擷取未壓縮視訊格式的影像大小，以位元組為單位。 （MFGetPlaneSize）
MFGetPluginControl 取得媒體基礎外掛程式管理員Microsoft指標。
MFGetStrideForBitmapInfoHeader 計算視訊格式的最小表面步幅。
MFGetTimerPeriodicity 擷取 MFAddPeriodicCallback 函式的定時器間隔。
MFGetUncompressedVideoFormat 傳回未壓縮視訊格式的FOURCC或 D3DFORMAT值。
MFGetWorkQueueMMCSSClass 擷取目前與此工作佇列相關聯的多媒體類別排程器服務 （MMCSS） 類別。 （MFGetWorkQueueMMCSSClass）
MFGetWorkQueueMMCSSPriority 取得工作佇列的相對線程優先順序。 （MFGetWorkQueueMMCSSPriority）
MFGetWorkQueueMMCSSTaskId 擷取目前與此工作佇列相關聯的多媒體類別排程器服務 （MMCSS） 工作標識符。 （MFGetWorkQueueMMCSSTaskId）
MFHeapAlloc 配置記憶體區塊。 （MFHeapAlloc）
MFHeapFree 釋放呼叫 MFHeapAlloc 函式所配置的記憶體區塊。
MFInitAMMediaTypeFromMFMediaType 從媒體基礎媒體類型初始化 DirectShow AM_MEDIA_TYPE 結構。
MFInitAttributesFromBlob 從位元組數位初始化屬性存放區的內容。
MFInitMediaTypeFromAMMediaType 從 DirectShow AM_MEDIA_TYPE 結構初始化媒體類型。
MFInitMediaTypeFromMFVideoFormat 從 MFVIDEOFORMAT 結構初始化媒體類型。
MFInitMediaTypeFromMPEG1VideoInfo 從 DirectShow MPEG1VIDEOINFO 結構初始化媒體類型。
MFInitMediaTypeFromMPEG2VideoInfo 從 DirectShow MPEG2VIDEOINFO 結構初始化媒體類型。
MFInitMediaTypeFromVideoInfoHeader 從 DirectShow VIDEOINFOHEADER 結構初始化媒體類型。
MFInitMediaTypeFromVideoInfoHeader2 從 DirectShow VIDEOINFOHEADER2 結構初始化媒體類型。
MFInitMediaTypeFromWaveFormatEx 從 SEMANTICATEX 結構初始化媒體類型。
MFInitVideoFormat 初始化標準視訊格式的 MFVIDEOFORMAT 結構，例如 DVD、模擬電視或 ATSC 數字電視。
MFInitVideoFormat_RGB 初始化未壓縮 RGB 視訊格式的 MFVIDEOFORMAT 結構。
MFInvokeCallback 叫用回呼方法以完成異步操作。 （MFInvokeCallback）
MFIsFormatYUV 查詢FOURCC程式碼或D3DFORMAT值是否為 YUV 格式。
MFllMulDiv 計算 （（a * b） + d） / c，其中每個字詞都是 64 位帶正負號的值。
MFLockDXGIDeviceManager 鎖定共用Microsoft DirectX 圖形基礎結構 （DXGI） 設備管理器。
MFLockPlatform 封鎖 MFShutdown 函式。
MFLockSharedWorkQueue 取得和鎖定共用工作佇列。 （MFLockSharedWorkQueue）
MFLockWorkQueue 鎖定工作佇列。 （MFLockWorkQueue）
MFMapDX9FormatToDXGIFormat 將 Microsoft Direct3D 9 格式識別碼轉換為 Microsoft DirectX 圖形基礎結構 （DXGI） 格式識別碼。
MFMapDXGIFormatToDX9Format 將 Microsoft DirectX 圖形基礎結構 （DXGI） 格式識別碼轉換為 Microsoft Direct3D 9 格式識別碼。
MFPutWaitingWorkItem 將等候事件發出訊號的工作專案排入佇列。 （MFPutWaitingWorkItem）
MFPutWorkItem 將異步操作放在工作佇列上。 （MFPutWorkItem）
MFPutWorkItem2 將異步操作放在具有指定優先權的工作佇列上。 （MFPutWorkItem2）
MFPutWorkItemEx 將異步操作放在工作佇列上。 （MFPutWorkItemEx）
MFPutWorkItemEx2 將異步操作放在具有指定優先權的工作佇列上。 （MFPutWorkItemEx2）
MFRegisterLocalByteStreamHandler 在呼叫端的進程中註冊位元組數據流處理程式。
MFRegisterLocalSchemeHandler 在呼叫端的進程中註冊配置處理程式。
MFRegisterPlatformWithMMCSS 向多媒體類別排程器服務 （MMCSS） 註冊標準Microsoft Media Foundation 平臺工作佇列。
MFRemovePeriodicCallback 取消 MFAddPeriodicCallback 函式所設定的回呼函式。
MFScheduleWorkItem 排程在指定間隔之後完成的異步操作。 （MFScheduleWorkItem）
MFScheduleWorkItemEx 排程在指定間隔之後完成的異步操作。 （MFScheduleWorkItemEx）
MFSetAttribute2UINT32asUINT64 將兩個 UINT32 值封裝成 UINT64 屬性值。
MFSetAttributeRatio 將比率設定為64位屬性值。
MFSetAttributeSize 將寬度和高度設定為單一 64 位屬性值。
MFShutdown 關閉 Microsoft Media Foundation 平臺。
MFSplitSample 將合併的媒體範例分割回個別範例。
MFStartup 初始化媒體基礎Microsoft。
MFTEnum 列舉登錄中的媒體基礎轉換 （MFT）。
MFTEnum2 取得符合指定搜尋準則的 Microsoft Media Foundation 轉換 （MFT） 清單。
MFTEnumEx 取得符合指定搜尋準則的 Microsoft Media Foundation 轉換 （MFT） 清單。 此函式會擴充 MFTEnum 函式。
MFTGetInfo 從登錄取得媒體基礎轉換 （MFT） 的相關信息。
MFTRegister 將媒體基礎轉換 （MFT） 的相關信息新增至登錄。
MFTRegisterLocal 在呼叫者的程式中註冊媒體基礎轉換 （MFT）。 （MFTRegisterLocal）
MFTRegisterLocalByCLSID 在呼叫者的程式中註冊媒體基礎轉換 （MFT）。 （MFTRegisterLocalByCLSID）
MFTUnregister 取消註冊媒體基礎轉換 （MFT）。
MFTUnregisterLocal 從呼叫端的程式取消註冊一或多個媒體基礎轉換（MFT）。
MFTUnregisterLocalByCLSID 從呼叫端的程式取消註冊媒體基礎轉換 （MFT）。
MFUnlockDXGIDeviceManager 解除鎖定共用Microsoft DirectX 圖形基礎結構 （DXGI） 設備管理器。
MFUnlockPlatform 在 MFLockPlatform 函式的呼叫鎖定媒體基礎平台之後解除鎖定。
MFUnlockWorkQueue 解除鎖定工作佇列。 （MFUnlockWorkQueue）
MFUnregisterPlatformFromMMCSS 從多媒體類別排程器服務 （MMCSS） 工作取消註冊 Microsoft Media Foundation 平臺工作佇列。
MFUnwrapMediaType 擷取由 MFWrapMediaType 函式包裝在另一種媒體類型中的媒體類型。
MFValidateMediaTypeSize 驗證視訊格式區塊的緩衝區大小。
MFWrapMediaType 建立包裝另一種媒體類型的媒體類型。
Pack2UINT32AsUINT64 將兩個 UINT32 值封裝成 UINT64 值。
PackRatio 將兩個代表比率的 UINT32 值封裝成 UINT64 值。
PackSize 將UINT32寬度值和UINT32高度值封裝成代表大小的UINT64值。
Unpack2UINT32AsUINT64 從 UINT64 值取得低序和高階 UINT32 值。
UnpackRatio 從代表比率的 UINT64 值，取得低序和高階 UINT32 值。
UnpackSize 從代表大小的 UINT64 值取得低序和高階 UINT32 值。

回呼函式

MFPERIODICCALLBACK MFAddPeriodicCallback 函式的回調函式。

結構體系

CapturedMetadataExposureCompensation 此結構包含所擷取相片之 EV 補償意見反應的 Blob 資訊。
CapturedMetadataISOGains CapturedMetadataISOGains 結構描述MF_CAPTURE_METADATA_ISO_GAINS的 Blob 格式。
CapturedMetadataWhiteBalanceGains 此結構描述 MF_CAPTURE_METADATA_WHITEBALANCE_GAINS 屬性的 Blob 格式。
DigitalWindowSetting 表示視訊擷取數位視窗的界限設定。
FaceFaceFace FaceScrib 結構描述MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS屬性的 Blob 格式。
FaceCharacterizationBlobHeader FaceScribBlobHeader 結構描述MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS屬性之 Blob 格式的大小和計數資訊。
FaceRectInfo FaceRectInfo 結構描述MF_CAPTURE_METADATA_FACEROIS屬性的 Blob 格式。
FaceRectInfoBlobHeader FaceRectInfoBlobHeader 結構描述MF_CAPTURE_METADATA_FACEROIS屬性之 Blob 格式的大小和計數資訊。
直方圖BlobHeader 直方圖BlobHeader 結構描述 blob 大小和 blob 中MF_CAPTURE_METADATA_HISTOGRAM屬性的直方圖數目。
HistogramDataHeader HistogramDataHeader 結構描述MF_CAPTURE_METADATA_HISTOGRAM屬性的 Blob 格式。
直方圖Grid 直方圖Grid 結構描述MF_CAPTURE_METADATA_HISTOGRAM的 Blob 格式。
直方圖Header 直方圖Header 結構描述MF_CAPTURE_METADATA_HISTOGRAM的 Blob 格式。
MACROBLOCK_DATA 提供影片譯碼期間宏區塊的相關數據。
MetadataTimeStamps MetadataTimeStamps 結構描述MF_CAPTURE_METADATA_FACEROITIMESTAMPS屬性的 Blob 格式。
MF_FLOAT2 具有兩個元件的向量。
MF_FLOAT3 具有三個元件的向量。
MF_QUATERNION 四維向量，用來表示旋轉。
MFASYNCRESULT 包含實作 IMFAsyncResult 介面所需的數據。
MFCameraExtrinsic_CalibratedTransform 轉換，描述相對於其他相機或已建立的外部參考的相機位置。
MFCameraExtrinsics 描述相機相對於其他相機或已建立的外部參考的位置。
MFCameraIntrinsic_DistortionModel 表示多項式鏡頭失真模型。
MFCameraIntrinsic_PinholeCameraModel 表示針孔相機模型。
MFFOLDDOWN_MATRIX 包含用來將多重通道音訊轉換成較少音訊通道的係數。 此程序稱為折疊。
MFPinholeCameraIntrinsic_IntrinsicModel 表示指定解析度的針孔相機內建模型。
MFPinholeCameraIntrinsics 包含零或 1 個針孔相機內建模型，描述如何將實體世界中的 3D 點投影到相機的 2D 圖像框架。
MFSampleExtensionPsnrYuv 儲存編碼視訊框架 Y、U 和 V 平面的尖峰訊與雜訊比率 （PSNR） 值。
MT_ARBITRARY_HEADER 包含進階串流格式 （ASF） 檔案中二進位數據流的格式數據。
MT_CUSTOM_VIDEO_PRIMARIES 定義視訊來源的自定義色彩初選。 色彩主要定義如何將色彩從 RGB 色彩空間轉換為 CIE XYZ 色彩空間。
ROI_AREA 定義感興趣的區域。

列舉項目

_MFT_ENUM_FLAG 包含註冊和列舉媒體基礎轉換 （MFT） 的旗標。
MF_TOPOSTATUS 指定在播放期間拓撲的狀態。
MFASYNC_WORKQUEUE_TYPE 指定要建立之 MFAllocateWorkQueueEx 函式的工作佇列類型。
MFDepthMeasurement 指定視訊畫面中深度值的測量系統。
MFFrameSourceTypes 描述框架來源所提供的數據類型。
MFSampleEncryptionProtectionScheme 指定加密範例支持的保護配置。
MFVideo3DFormat 指定 3D 視訊畫面儲存在記憶體中的方式。
MFVideo3DSampleFormat 指定 3D 視訊畫面儲存在媒體範例中的方式。
MFVideoDRMFlags 指定視訊串流所需的複製保護類型。
MFVideoPadFlags 指定是否要填補視訊影像，使其符合指定的外觀比例。
MFVideoRotationFormat 描述視訊影像在逆時針方向旋轉。
MFVideoSrcContentHintFlags 描述視訊串流的預期外觀比例。
MFWaveFormatExConvertFlags 包含旗標，指定如何轉換音訊媒體類型。