Funzione MFBeginCreateFile (mfapi.h)

Articolo
08/24/2023

Avvia una richiesta asincrona per creare un flusso di byte da un file.

Sintassi

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

Parametri

[in] AccessMode

La modalità di accesso richiesta, specificata come membro dell'enumerazione MF_FILE_ACCESSMODE .

[in] OpenMode

Comportamento della funzione se il file esiste già o non esiste, specificato come membro dell'enumerazione MF_FILE_OPENMODE .

[in] fFlags

OR bit per bit dei valori dell'enumerazione MF_FILE_FLAGS.

[in] pwszFilePath

Puntatore a una stringa con terminazione null contenente il nome del file.

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Il chiamante deve implementare questa interfaccia

[in] pState

Puntatore all'interfaccia IUnknown di un oggetto stato, definito dal chiamante. Questo parametro può essere NULL. È possibile usare questo oggetto per contenere informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

[out] ppCancelCookie

Riceve un puntatore IUnknown o il valore NULL. Se il valore non è NULL, è possibile annullare l'operazione asincrona passando questo puntatore alla funzione MFCancelCreateFile . Il chiamante deve rilasciare l'interfaccia. Questo parametro è facoltativo e può essere NULL.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Funzione completata.

Commenti

Al termine della richiesta, viene chiamato il metodo FMAsyncCallback::Invoke dell'oggetto callback. L'oggetto callback deve quindi chiamare la funzione MFEndCreateFile per ottenere un puntatore al flusso di byte.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Mfplat.lib
DLL	Mfplat.dll

Vedi anche

Funzioni di Media Foundation

Condividi tramite