mfapi.h header
This header is used by multiple technologies. For more information, see:
mfapi.h contains the following programming interfaces:
Functions
| DEFINE_MEDIATYPE_GUID Defines a media subtype GUID from a FOURCC code, D3DFORMAT value, or audio format type. |
| MFAddPeriodicCallback Sets a callback function to be called at a fixed interval. (MFAddPeriodicCallback) |
| MFAllocateSerialWorkQueue Creates a work queue that is guaranteed to serialize work items. |
| MFAllocateWorkQueue Creates a new work queue. (MFAllocateWorkQueue) |
| MFAllocateWorkQueueEx Creates a new work queue. (MFAllocateWorkQueueEx) |
| MFAverageTimePerFrameToFrameRate Calculates the frame rate, in frames per second, from the average duration of a video frame. |
| MFBeginCreateFile Begins an asynchronous request to create a byte stream from a file. |
| MFBeginRegisterWorkQueueWithMMCSS Associates a work queue with a Multimedia Class Scheduler Service (MMCSS) task. (MFBeginRegisterWorkQueueWithMMCSS) |
| MFBeginRegisterWorkQueueWithMMCSSEx Associates a work queue with a Multimedia Class Scheduler Service (MMCSS) task. (MFBeginRegisterWorkQueueWithMMCSSEx) |
| MFBeginUnregisterWorkQueueWithMMCSS Unregisters a work queue from a Multimedia Class Scheduler Service (MMCSS) task. (MFBeginUnregisterWorkQueueWithMMCSS) |
| MFCalculateBitmapImageSize Retrieves the image size for a video format. |
| MFCalculateImageSize Retrieves the image size, in bytes, for an uncompressed video format. (MFCalculateImageSize) |
| MFCancelCreateFile Cancels an asynchronous request to create a byte stream from a file. |
| MFCancelWorkItem Attempts to cancel an asynchronous operation that was scheduled with MFScheduleWorkItem or MFScheduleWorkItemEx. |
| MFCombineSamples Concatenates a media sample onto another sample if their combined duration does not exceed the specified duration. |
| MFCompareFullToPartialMediaType Compares a full media type to a partial media type. |
| MFConvertColorInfoFromDXVA Sets the extended color information in a MFVIDEOFORMAT structure. |
| MFConvertColorInfoToDXVA Converts the extended color information from an MFVIDEOFORMAT to the equivalent DirectX Video Acceleration (DXVA) color information. |
| MFConvertFromFP16Array Converts an array of 16-bit floating-point numbers into an array of 32-bit floating-point numbers. |
| MFConvertToFP16Array Converts an array of 32-bit floating-point numbers into an array of 16-bit floating-point numbers. |
| MFCopyImage Copies an image or image plane from one buffer to another. |
| MFCreate2DMediaBuffer Creates a system-memory buffer object to hold 2D image data. |
| MFCreateAlignedMemoryBuffer Allocates system memory with a specified byte alignment and creates a media buffer to manage the memory. |
| MFCreateAMMediaTypeFromMFMediaType Creates a DirectShow AM_MEDIA_TYPE structure from a Media Foundation media type. |
| MFCreateAsyncResult Creates an asynchronous result object. Use this function if you are implementing an asynchronous method. (MFCreateAsyncResult) |
| MFCreateAttributes Creates an empty attribute store. |
| MFCreateAudioMediaType Creates an audio media type from a WAVEFORMATEX structure. |
| MFCreateCollection Creates an empty collection object. |
| MFCreateDXGIDeviceManager Creates an instance of the Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager. |
| MFCreateDXGISurfaceBuffer Creates a media buffer to manage a Microsoft DirectX Graphics Infrastructure (DXGI) surface. |
| MFCreateDXSurfaceBuffer Creates a media buffer object that manages a Direct3D 9 surface. |
| MFCreateEventQueue Creates an event queue. |
| MFCreateFile Creates a byte stream from a file. |
| MFCreateLegacyMediaBufferOnMFMediaBuffer Converts a Media Foundation media buffer into a buffer that is compatible with DirectX Media Objects (DMOs). |
| MFCreateMediaBufferFromMediaType Allocates a system-memory buffer that is optimal for a specified media type. |
| MFCreateMediaBufferWrapper Creates a media buffer that wraps an existing media buffer. |
| MFCreateMediaEvent Creates a media event object. |
| MFCreateMediaExtensionActivate Creates an activation object for a Windows Runtime class. |
| MFCreateMediaType Creates an empty media type. |
| MFCreateMediaTypeFromRepresentation Creates a Media Foundation media type from another format representation. |
| MFCreateMemoryBuffer Allocates system memory and creates a media buffer to manage it. |
| MFCreateMFByteStreamWrapper Creates a wrapper for a byte stream. |
| MFCreateMFVideoFormatFromMFMediaType Creates an MFVIDEOFORMAT structure from a video media type. |
| MFCreateMuxStreamAttributes Creates an IMFAttributes describing the content of multiplexed substreams. |
| MFCreateMuxStreamMediaType Creates an IMFMediaType describing the media types of multiplexed substreams. |
| MFCreateMuxStreamSample Creates an IMFSample containing the samples of multiplexed substreams. |
| MFCreateSample Creates an empty media sample. |
| MFCreateTempFile Creates a byte stream that is backed by a temporary local file. |
| MFCreateVideoMediaType Creates a video media type from an MFVIDEOFORMAT structure. |
| MFCreateVideoMediaTypeFromBitMapInfoHeader This function is not implemented. (MFCreateVideoMediaTypeFromBitMapInfoHeader) |
| MFCreateVideoMediaTypeFromBitMapInfoHeaderEx Creates a video media type from a BITMAPINFOHEADER structure. |
| MFCreateVideoMediaTypeFromSubtype Creates a partial video media type with a specified subtype. |
| MFCreateVideoMediaTypeFromVideoInfoHeader Creates a media type from a KS_VIDEOINFOHEADER structure. |
| MFCreateVideoMediaTypeFromVideoInfoHeader2 Creates a media type from a KS_VIDEOINFOHEADER2 structure. |
| MFCreateVideoSampleAllocatorEx Creates an object that allocates video samples that are compatible with Microsoft DirectX Graphics Infrastructure (DXGI). |
| MFCreateWaveFormatExFromMFMediaType Converts a Media Foundation audio media type to a WAVEFORMATEX structure. |
| MFCreateWICBitmapBuffer Creates a media buffer object that manages a Windows Imaging Component (WIC). |
| MFEndCreateFile Completes an asynchronous request to create a byte stream from a file. |
| MFEndRegisterWorkQueueWithMMCSS Completes an asynchronous request to associate a work queue with a Multimedia Class Scheduler Service (MMCSS) task. (MFEndRegisterWorkQueueWithMMCSS) |
| MFEndUnregisterWorkQueueWithMMCSS Completes an asynchronous request to unregister a work queue from a Multimedia Class Scheduler Service (MMCSS) task. |
| MFFrameRateToAverageTimePerFrame Converts a video frame rate into a frame duration. |
| MFGetAttribute2UINT32asUINT64 Gets an attribute whose value is two UINT32 values packed into a UINT64. |
| MFGetAttributeDouble Returns a double value from an attribute store, or a default value if the attribute is not present. |
| MFGetAttributeRatio Retrieves an attribute whose value is a ratio. |
| MFGetAttributesAsBlob Converts the contents of an attribute store to a byte array. |
| MFGetAttributesAsBlobSize Retrieves the size of the buffer needed for the MFGetAttributesAsBlob function. |
| MFGetAttributeSize Retrieves an attribute whose value is a size, expressed as a width and height. |
| MFGetAttributeString Gets a string value from an attribute store. |
| MFGetAttributeUINT32 Returns a UINT32 value from an attribute store, or a default value if the attribute is not present. |
| MFGetAttributeUINT64 Returns a UINT64 value from an attribute store, or a default value if the attribute is not present. |
| MFGetContentProtectionSystemCLSID Gets the class identifier for a content protection system. |
| MFGetMFTMerit Gets the merit value of a hardware codec. |
| MFGetPlaneSize Retrieves the image size, in bytes, for an uncompressed video format. (MFGetPlaneSize) |
| MFGetPluginControl Gets a pointer to the Microsoft Media Foundation plug-in manager. |
| MFGetStrideForBitmapInfoHeader Calculates the minimum surface stride for a video format. |
| MFGetTimerPeriodicity Retrieves the timer interval for the MFAddPeriodicCallback function. |
| MFGetUncompressedVideoFormat Returns the FOURCC or D3DFORMAT value for an uncompressed video format. |
| MFGetWorkQueueMMCSSClass Retrieves the Multimedia Class Scheduler Service (MMCSS) class currently associated with this work queue. (MFGetWorkQueueMMCSSClass) |
| MFGetWorkQueueMMCSSPriority Gets the relative thread priority of a work queue. (MFGetWorkQueueMMCSSPriority) |
| MFGetWorkQueueMMCSSTaskId Retrieves the Multimedia Class Scheduler Service (MMCSS) task identifier currently associated with this work queue. (MFGetWorkQueueMMCSSTaskId) |
| MFHeapAlloc Allocates a block of memory. (MFHeapAlloc) |
| MFHeapFree Frees a block of memory that was allocated by calling the MFHeapAlloc function. |
| MFInitAMMediaTypeFromMFMediaType Initializes a DirectShow AM_MEDIA_TYPE structure from a Media Foundation media type. |
| MFInitAttributesFromBlob Initializes the contents of an attribute store from a byte array. |
| MFInitMediaTypeFromAMMediaType Initializes a media type from a DirectShow AM_MEDIA_TYPE structure. |
| MFInitMediaTypeFromMFVideoFormat Initializes a media type from an MFVIDEOFORMAT structure. |
| MFInitMediaTypeFromMPEG1VideoInfo Initializes a media type from a DirectShow MPEG1VIDEOINFO structure. |
| MFInitMediaTypeFromMPEG2VideoInfo Initializes a media type from a DirectShow MPEG2VIDEOINFO structure. |
| MFInitMediaTypeFromVideoInfoHeader Initializes a media type from a DirectShow VIDEOINFOHEADER structure. |
| MFInitMediaTypeFromVideoInfoHeader2 Initializes a media type from a DirectShow VIDEOINFOHEADER2 structure. |
| MFInitMediaTypeFromWaveFormatEx Initializes a media type from a WAVEFORMATEX structure. |
| MFInitVideoFormat Initializes an MFVIDEOFORMAT structure for a standard video format such as DVD, analog television, or ATSC digital television. |
| MFInitVideoFormat_RGB Initializes an MFVIDEOFORMAT structure for an uncompressed RGB video format. |
| MFInvokeCallback Invokes a callback method to complete an asynchronous operation. (MFInvokeCallback) |
| MFIsFormatYUV Queries whether a FOURCC code or D3DFORMAT value is a YUV format. |
| MFllMulDiv Calculates ((a * b) + d) / c, where each term is a 64-bit signed value. |
| MFLockDXGIDeviceManager Locks the shared Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager. |
| MFLockPlatform Blocks the MFShutdown function. |
| MFLockSharedWorkQueue Obtains and locks a shared work queue. (MFLockSharedWorkQueue) |
| MFLockWorkQueue Locks a work queue. (MFLockWorkQueue) |
| MFMapDX9FormatToDXGIFormat Converts a Microsoft Direct3D 9 format identifier to a Microsoft DirectX Graphics Infrastructure (DXGI) format identifier. |
| MFMapDXGIFormatToDX9Format Converts a Microsoft DirectX Graphics Infrastructure (DXGI) format identifier to a Microsoft Direct3D 9 format identifier. |
| MFPutWaitingWorkItem Queues a work item that waits for an event to be signaled. (MFPutWaitingWorkItem) |
| MFPutWorkItem Puts an asynchronous operation on a work queue. (MFPutWorkItem) |
| MFPutWorkItem2 Puts an asynchronous operation on a work queue, with a specified priority. (MFPutWorkItem2) |
| MFPutWorkItemEx Puts an asynchronous operation on a work queue. (MFPutWorkItemEx) |
| MFPutWorkItemEx2 Puts an asynchronous operation on a work queue, with a specified priority. (MFPutWorkItemEx2) |
| MFRegisterLocalByteStreamHandler Registers a byte-stream handler in the caller's process. |
| MFRegisterLocalSchemeHandler Registers a scheme handler in the caller's process. |
| MFRegisterPlatformWithMMCSS Registers the standard Microsoft Media Foundation platform work queues with the Multimedia Class Scheduler Service (MMCSS). |
| MFRemovePeriodicCallback Cancels a callback function that was set by the MFAddPeriodicCallback function. |
| MFScheduleWorkItem Schedules an asynchronous operation to be completed after a specified interval. (MFScheduleWorkItem) |
| MFScheduleWorkItemEx Schedules an asynchronous operation to be completed after a specified interval. (MFScheduleWorkItemEx) |
| MFSetAttribute2UINT32asUINT64 Packs two UINT32 values into a UINT64 attribute value. |
| MFSetAttributeRatio Sets a ratio as a 64-bit attribute value. |
| MFSetAttributeSize Sets width and height as a single 64-bit attribute value. |
| MFShutdown Shuts down the Microsoft Media Foundation platform. |
| MFSplitSample Split up a combined media sample back into individual samples. |
| MFStartup Initializes Microsoft Media Foundation. |
| MFTEnum Enumerates Media Foundation transforms (MFTs) in the registry. |
| MFTEnum2 Gets a list of Microsoft Media Foundation transforms (MFTs) that match specified search criteria. |
| MFTEnumEx Gets a list of Microsoft Media Foundation transforms (MFTs) that match specified search criteria. This function extends the MFTEnum function. |
| MFTGetInfo Gets information from the registry about a Media Foundation transform (MFT). |
| MFTRegister Adds information about a Media Foundation transform (MFT) to the registry. |
| MFTRegisterLocal Registers a Media Foundation transform (MFT) in the caller's process. (MFTRegisterLocal) |
| MFTRegisterLocalByCLSID Registers a Media Foundation transform (MFT) in the caller's process. (MFTRegisterLocalByCLSID) |
| MFTUnregister Unregisters a Media Foundation transform (MFT). |
| MFTUnregisterLocal Unregisters one or more Media Foundation transforms (MFTs) from the caller's process. |
| MFTUnregisterLocalByCLSID Unregisters a Media Foundation transform (MFT) from the caller's process. |
| MFUnlockDXGIDeviceManager Unlocks the shared Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager. |
| MFUnlockPlatform Unlocks the Media Foundation platform after it was locked by a call to the MFLockPlatform function. |
| MFUnlockWorkQueue Unlocks a work queue. (MFUnlockWorkQueue) |
| MFUnregisterPlatformFromMMCSS Unregisters the Microsoft Media Foundation platform work queues from a Multimedia Class Scheduler Service (MMCSS) task. |
| MFUnwrapMediaType Retrieves a media type that was wrapped in another media type by the MFWrapMediaType function. |
| MFValidateMediaTypeSize Validates the size of a buffer for a video format block. |
| MFWrapMediaType Creates a media type that wraps another media type. |
| Pack2UINT32AsUINT64 Packs two UINT32 values into a UINT64 value. |
| PackRatio Packs two UINT32 values, which represent a ratio, into a UINT64 value. |
| PackSize Packs a UINT32 width value and a UINT32 height value into a UINT64 value that represents a size. |
| Unpack2UINT32AsUINT64 Gets the low-order and high-order UINT32 values from a UINT64 value. |
| UnpackRatio Gets the low-order and high-order UINT32 values from a UINT64 value that represents a ratio. |
| UnpackSize Gets the low-order and high-order UINT32 values from a UINT64 value that represents a size. |
Callback functions
| MFPERIODICCALLBACK Callback function for the MFAddPeriodicCallback function. |
Structures
| CapturedMetadataExposureCompensation This structure contains blob information for the EV compensation feedback for the photo captured. |
| CapturedMetadataISOGains The CapturedMetadataISOGains structure describes the blob format for MF_CAPTURE_METADATA_ISO_GAINS. |
| CapturedMetadataWhiteBalanceGains This structure describes the blob format for the MF_CAPTURE_METADATA_WHITEBALANCE_GAINS attribute. |
| DigitalWindowSetting Represents the bounds settings of the digital window for video capture. |
| FaceCharacterization The FaceCharacterization structure describes the blob format for the MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS attribute. |
| FaceCharacterizationBlobHeader The FaceCharacterizationBlobHeader structure describes the size and count information of the blob format for the MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS attribute. |
| FaceRectInfo The FaceRectInfo structure describes the blob format for the MF_CAPTURE_METADATA_FACEROIS attribute. |
| FaceRectInfoBlobHeader The FaceRectInfoBlobHeader structure describes the size and count information of the blob format for the MF_CAPTURE_METADATA_FACEROIS attribute. |
| HistogramBlobHeader The HistogramBlobHeader structure describes the blob size and the number of histograms in the blob for the MF_CAPTURE_METADATA_HISTOGRAM attribute. |
| HistogramDataHeader The HistogramDataHeader structure describes the blob format for the MF_CAPTURE_METADATA_HISTOGRAM attribute. |
| HistogramGrid The HistogramGrid structure describes the blob format for MF_CAPTURE_METADATA_HISTOGRAM. |
| HistogramHeader The HistogramHeader structure describes the blob format for MF_CAPTURE_METADATA_HISTOGRAM. |
| MACROBLOCK_DATA Provides data about a macroblock during video decoding. |
| MetadataTimeStamps The MetadataTimeStamps structure describes the blob format for the MF_CAPTURE_METADATA_FACEROITIMESTAMPS attribute. |
| MF_FLOAT2 A vector with two components. |
| MF_FLOAT3 A vector with three components. |
| MF_QUATERNION A four dimensional vector, used to represent a rotation. |
| MFASYNCRESULT Contains data that is needed to implement the IMFAsyncResult interface. |
| MFCameraExtrinsic_CalibratedTransform A transform describing the location of a camera relative to other cameras or an established external reference. |
| MFCameraExtrinsics Describes the location of a camera relative to other cameras or an established external reference. |
| MFCameraIntrinsic_DistortionModel Represents a polynomial lens distortion model. |
| MFCameraIntrinsic_PinholeCameraModel Represents a pinhole camera model. |
| MFFOLDDOWN_MATRIX Contains coefficients used to transform multichannel audio into a smaller number of audio channels. This process is called fold-down. |
| MFPinholeCameraIntrinsic_IntrinsicModel Represents a pinhole camera intrinsic model for a specified resolution. |
| MFPinholeCameraIntrinsics Contains zero or 1 pinhole camera intrinsic models that describe how to project a 3D point in physical world onto the 2D image frame of a camera. |
| MT_ARBITRARY_HEADER Contains format data for a binary stream in an Advanced Streaming Format (ASF) file. |
| MT_CUSTOM_VIDEO_PRIMARIES Defines custom color primaries for a video source. The color primaries define how to convert colors from RGB color space to CIE XYZ color space. |
| ROI_AREA Defines a regions of interest. |
Enumerations
| _MFT_ENUM_FLAG Contains flags for registering and enumeration Media Foundation transforms (MFTs). |
| MF_TOPOSTATUS Specifies the status of a topology during playback. |
| MFASYNC_WORKQUEUE_TYPE Specifies the type of work queue for the MFAllocateWorkQueueEx function to create. |
| MFDepthMeasurement Specifies the measurement system for a depth value in a video frame. |
| MFFrameSourceTypes Describes the type of data provided by a frame source. |
| MFSampleEncryptionProtectionScheme Specifies the supported protection schemes for encrypted samples. |
| MFVideo3DFormat Specifies how 3D video frames are stored in memory. |
| MFVideo3DSampleFormat Specifies how a 3D video frame is stored in a media sample. |
| MFVideoDRMFlags Specifies the type of copy protection required for a video stream. |
| MFVideoPadFlags Specifies whether to pad a video image so that it fits within a specified aspect ratio. |
| MFVideoRotationFormat Describes the rotation of the video image in the counter-clockwise direction. |
| MFVideoSrcContentHintFlags Describes the intended aspect ratio for a video stream. |
| MFWaveFormatExConvertFlags Contains flags that specify how to convert an audio media type. |