Función MFBeginCreateFile (mfapi.h)

Comienza una solicitud asincrónica para crear una secuencia de bytes a partir de un archivo.

Sintaxis

HRESULT MFBeginCreateFile(
  [in]  MF_FILE_ACCESSMODE AccessMode,
  [in]  MF_FILE_OPENMODE   OpenMode,
  [in]  MF_FILE_FLAGS      fFlags,
  [in]  LPCWSTR            pwszFilePath,
  [in]  IMFAsyncCallback   *pCallback,
  [in]  IUnknown           *pState,
  [out] IUnknown           **ppCancelCookie
);

Parámetros

[in] AccessMode

Modo de acceso solicitado, especificado como miembro de la enumeración MF_FILE_ACCESSMODE .

[in] OpenMode

Comportamiento de la función si el archivo ya existe o no existe, especificado como miembro de la enumeración MF_FILE_OPENMODE .

[in] fFlags

OR bit a bit de los valores de la enumeración MF_FILE_FLAGS.

[in] pwszFilePath

Puntero a una cadena terminada en null que contiene el nombre de archivo.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz.

[in] pState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

[out] ppCancelCookie

Recibe un puntero IUnknown o el valor NULL. Si el valor no es NULL, puede cancelar la operación asincrónica pasando este puntero a la función MFCancelCreateFile . El autor de la llamada debe liberar la interfaz . Este parámetro es opcional y puede ser NULL.

Valor devuelto

La función devuelve un VALOR HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	La función se ha realizado correctamente.

Comentarios

Cuando se completa la solicitud, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. A continuación, el objeto de devolución de llamada debe llamar a la función MFEndCreateFile para obtener un puntero a la secuencia de bytes.

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	Mfplat.lib
Archivo DLL	Mfplat.dll

Consulte también

Funciones de Media Foundation