From: short <>
Date: Wed, 16 Jul 2003 06:01:48 +0000 (+0000)
Subject: CcRemapBcb(): +comments wrt functions applied to the resulting Bcb.
X-Git-Tag: bp_captive~122
X-Git-Url: http://git.jankratochvil.net/?a=commitdiff_plain;h=421811cb741309fed837558959756c38c2bd934b;p=captive.git

CcRemapBcb(): +comments wrt functions applied to the resulting Bcb.
---

diff --git a/src/libcaptive/cc/map.c b/src/libcaptive/cc/map.c
index f5319da..27700eb 100644
--- a/src/libcaptive/cc/map.c
+++ b/src/libcaptive/cc/map.c
@@ -2541,6 +2541,12 @@ VOID CcUnpinDataForThread(IN PVOID Bcb,IN ERESOURCE_THREAD ResourceThreadId)
  *
  * libcaptive calls CcMapData() internally with @Bcb parameters.
  *
+ * This function is called only by ntfs.sys of NT-5.1sp1 and it will perform
+ * these operations with the resulting #PUBLIC_BCB:
+ * CcRemapBcb(), CcSetDirtyPinnedData(), CcUnpinData()
+ *
+ * Untested: This call does not set the buffer as dirty - such buffer will not be flushed automatically.
+ *
  * Returns: Copy of @Bcb. This _pointer_ never equals to @Bcb.
  * It should be some different
  * #PUBLIC_BCB structure according to W32 doc.
@@ -2569,7 +2575,7 @@ struct private_bcb *privbcb;
 			privbcb->FileObject,	/* FileObject */
 			&privbcb->MappedFileOffset,	/* FileOffset */
 			privbcb->MappedLength,	/* Length */
-			MAP_WAIT,	/* Flags; && !MAP_NO_READ */
+			MAP_WAIT,	/* Flags; FIXME: Is it OK to?: && !MAP_NO_READ */
 			&r,	/* Bcb */
 			&Buffer_unused); /* Buffer */
 	g_return_val_if_fail(errbool==TRUE,NULL);