MFBeginCreateFile-Funktion (mfapi.h)

  • Artikel

Startet eine asynchrone Anforderung zum Erstellen eines Bytedatenstroms aus einer Datei.

Syntax

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

Parameter

[in] AccessMode

Der angeforderte Zugriffsmodus, der als Member der MF_FILE_ACCESSMODE-Enumeration angegeben wird.

[in] OpenMode

Das Verhalten der Funktion, wenn die Datei bereits vorhanden ist oder nicht vorhanden ist, angegeben als Member der MF_FILE_OPENMODE-Enumeration .

[in] fFlags

Bitweise OR von Werten aus der MF_FILE_FLAGS-Enumeration .

[in] pwszFilePath

Zeiger auf eine NULL-beendete Zeichenfolge, die den Dateinamen enthält.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren.

[in] pState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen zu enthalten. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

[out] ppCancelCookie

Empfängt einen IUnknown-Zeiger oder den Wert NULL. Wenn der Wert nicht NULL ist, können Sie den asynchronen Vorgang abbrechen, indem Sie diesen Zeiger an die MFCancelCreateFile-Funktion übergeben. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Wenn die Anforderung abgeschlossen ist, wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Das Rückrufobjekt sollte dann die MFEndCreateFile-Funktion aufrufen, um einen Zeiger auf den Bytedatenstrom abzurufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen