Fonction MFBeginCreateFile (mfapi.h)

Article
08/24/2023

Commence une demande asynchrone pour créer un flux d’octets à partir d’un fichier.

Syntaxe

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
);

Paramètres

[in] AccessMode

Mode d’accès demandé, spécifié en tant que membre de l’énumération MF_FILE_ACCESSMODE .

[in] OpenMode

Comportement de la fonction si le fichier existe déjà ou n’existe pas, spécifié en tant que membre de l’énumération MF_FILE_OPENMODE .

[in] fFlags

OR au niveau du bit des valeurs de l’énumération MF_FILE_FLAGS.

[in] pwszFilePath

Pointeur vers une chaîne terminée par null contenant le nom de fichier.

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel. L’appelant doit implémenter cette interface

[in] pState

Pointeur vers l’interface IUnknown d’un objet d’état, défini par l’appelant. Ce paramètre peut être NULL. Vous pouvez utiliser cet objet pour stocker des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.

[out] ppCancelCookie

Reçoit un pointeur IUnknown ou la valeur NULL. Si la valeur n’est pas NULL, vous pouvez annuler l’opération asynchrone en passant ce pointeur à la fonction MFCancelCreateFile . L’appelant doit libérer l’interface. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	La fonction a réussi.

Notes

Une fois la demande terminée, la méthode IMFAsyncCallback::Invoke de l’objet de rappel est appelée. L’objet de rappel doit ensuite appeler la fonction MFEndCreateFile pour obtenir un pointeur vers le flux d’octets.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfapi.h
Bibliothèque	Mfplat.lib
DLL	Mfplat.dll

Voir aussi

Fonctions Media Foundation