Funzione MFBeginCreateFile (mfapi.h)
Avvia una richiesta asincrona per creare un flusso di byte da un file.
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
);
[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.
La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
Codice restituito | Descrizione |
---|---|
|
Funzione completata. |
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.
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 |