Função MFBeginCreateFile (mfapi.h)

Inicia uma solicitação assíncrona para criar um fluxo de bytes de um arquivo.

Sintaxe

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

O modo de acesso solicitado, especificado como membro da enumeração MF_FILE_ACCESSMODE .

[in] OpenMode

O comportamento da função se o arquivo já existir ou não existir, especificado como membro da enumeração MF_FILE_OPENMODE .

[in] fFlags

OR bit a bit de valores da enumeração MF_FILE_FLAGS.

[in] pwszFilePath

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo.

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface

[in] pState

Ponteiro para a interface IUnknown de um objeto de estado, definido pelo chamador. Este parâmetro pode ser NULL. Você pode usar esse objeto para armazenar informações de estado. O objeto é retornado ao chamador quando o retorno de chamada é invocado.

[out] ppCancelCookie

Recebe um ponteiro IUnknown ou o valor NULL. Se o valor não for NULL, você poderá cancelar a operação assíncrona passando esse ponteiro para a função MFCancelCreateFile . O chamador deve liberar a interface. Esse parâmetro é opcional e pode ser NULL.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	A função foi bem-sucedida.

Comentários

Quando a solicitação é concluída, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada é chamado. Em seguida, o objeto de retorno de chamada deve chamar a função MFEndCreateFile para obter um ponteiro para o fluxo de bytes.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfapi.h
Biblioteca	Mfplat.lib
DLL	Mfplat.dll

Confira também

Funções do Media Foundation