Funzione CcCopyWrite (ntifs.h)
La routine CcCopyWrite copia i dati da un buffer utente a un file memorizzato nella cache.
Sintassi
BOOLEAN CcCopyWrite(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] BOOLEAN Wait,
[in] PVOID Buffer
);
Parametri
[in] FileObject
Puntatore a un oggetto file per il file memorizzato nella cache in cui scrivere i dati.
[in] FileOffset
Puntatore a una variabile che specifica l'offset di byte iniziale all'interno del file memorizzato nella cache.
[in] Length
Lunghezza in byte dei dati da scrivere.
[in] Wait
Impostare su TRUE se il chiamante può essere inserito in uno stato di attesa fino a quando tutti i dati non sono stati copiati, FALSE in caso contrario.
[in] Buffer
Puntatore al buffer da cui copiare i dati.
Valore restituito
La routine CcCopyWrite restituisce TRUE se i dati sono stati copiati correttamente, FALSE in caso contrario.
Commenti
Se Wait è TRUE, CcCopyWrite è garantito di completare la richiesta di copia e restituire TRUE. Se le pagine necessarie del file memorizzato nella cache sono già residenti in memoria, i dati verranno copiati immediatamente e non si verificherà alcun blocco. Se le pagine necessarie non sono residenti, il chiamante verrà inserito in uno stato di attesa fino a quando tutte le pagine necessarie non sono state effettuate e i dati possono essere copiati.
Se Wait è FALSE, CcCopyWrite rifiuterà di bloccare e restituirà FALSE, se le pagine necessarie del file memorizzato nella cache non sono già residenti in memoria o se il flag di FO_WRITE_THROUGH è impostato sull'oggetto file.
Se si verifica un errore, CcCopyWrite genera un'eccezione di stato per tale errore specifico. Ad esempio, se si verifica un errore di allocazione del pool, CcCopyWrite genera un'eccezione STATUS_INSUFFICIENT_RESOURCES; se si verifica un errore di I/O, CcCopyWrite genera l'eccezione di stato dell'errore di I/O. Pertanto, per ottenere il controllo se si verifica un errore, il driver deve eseguire il wrapping della chiamata a CcCopyWrite in un'istruzione try-except o try-finally.
Per memorizzare nella cache un file, usare CcInitializeCacheMap.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 |
Piattaforma di destinazione | Universale |
Intestazione | ntifs.h (include Ntifs.h, FltKernel.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |