Función MFInitVideoFormat (mfapi.h)

  • Artículo

[Esta API no se admite y puede modificarse o no estar disponible en el futuro. Las aplicaciones deben evitar usar la estructura MFVIDEOFORMAT y usar atributos de tipo multimedia en su lugar. Para obtener más información, vea Tipos de medios de vídeo.]

Inicializa una estructura MFVIDEOFORMAT para un formato de vídeo estándar, como DVD, televisión analógica o televisión digital ATSC.

Sintaxis

HRESULT MFInitVideoFormat(
  [out] MFVIDEOFORMAT         *pVideoFormat,
  [in]  MFStandardVideoFormat type
);

Parámetros

[out] pVideoFormat

Puntero a una estructura MFVIDEOFORMAT . La función rellena los miembros de la estructura en función del formato de vídeo especificado en el parámetro type.

[in] type

Formato de vídeo, especificado como miembro de la enumeración MFStandardVideoFormat .

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Nota Antes de Windows 7, esta función se exportó desde evr.dll. A partir de Windows 7, esta función se exporta desde mfplat.dll y evr.dll exporta una función de código auxiliar que llama a mfplat.dll. Para obtener más información, consulta Cambios de biblioteca en Windows 7.
 

Ejemplos

En el ejemplo siguiente se crea un objeto de tipo multimedia para un formato de vídeo estándar.

// Creates a media type for a standard video format.
HRESULT CreateStandardVideoMediaType(MFStandardVideoFormat type, IMFMediaType **ppMediaType)
{
    IMFMediaType *pMediaType = NULL;

    MFVIDEOFORMAT format;

    // Fill in the MFVIDEOFORMAT structure for the video format.
    HRESULT hr = MFInitVideoFormat(&format, type);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create a new (empty) media type.
    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    // Initialize the media type from the MFVIDEOFORMAT structure.
    hr = MFInitMediaTypeFromMFVideoFormat(pMediaType, &format, sizeof(format));
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppMediaType = pMediaType;
    (*ppMediaType)->AddRef();

done:
    SafeRelease(&pMediaType);
    return hr;
}

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfapi.h
Library Evr.lib
Archivo DLL Mfplat.dll

Consulte también

Funciones de Media Foundation

Tipos de medios

Tipos de medios de vídeo