EWF Module

From LEXWiKi

(Difference between revisions)

Current revision

1 Why to use EWF?
2 How many modes does EWF has?
3 What's different about the modes?
4 The Sample code source you can download form
5 How to use the DEMO application
6 Sample code Introduction

Why to use EWF?

Enhanced Write Filter (EWF) provides the ability to write-protect a run-time image. By redirecting all write requests to either a separate disk partition(Disk mode) or RAM(Ram-Reg mode).

How many modes does EWF has?

There are Disk mode and Ram-Reg mode.

What's different about the modes?

Ram-Reg mode works by clear all the write requests when reboot.

1.System will restore when reboot.
2.Doesn't need any other invisible partition.

Disk mode works by the check point and restore.So Disk mode needs an invisible partition to save the write request of the check points.

1.Can set 9 check points.
2.Doesn't restore when reboot only if enter a restore commend.
3.Need an invisible partition in storage.
4.If you will do a big write request , ex:download some file , please disable the EWF first. 
  If the size of the write request is bigger than the size of the invisible partition. The WES will be crash.
5.There are no Disk mode in WES7.

The Sample code source you can download form

Source file: EWF_Manager_Src_v1.5

Binary file: EWF_Manager_Bin_v1.5

<FTP>

Source file: EWF_Manager_Src_v1.5

Binary file: EWF_Manager_Bin_v1.5

How to use the DEMO application

1&2.Choose the EWF partition.

3.Enable EWF.

4.Disable EWF.

5.Commit EWF-In RAM-Reg mod:Can do change on OS without reboot.In DISK mode,the layer will set to 1.

6.Clear the command which you chose.

7.Show the drive information.

8.Show the EWF information.

9.Reboot.

10.After choose the EWF partition,here will show the EWF infomation.

11.You can set checkpoint when DISK mode.

12.Choose the layer which you want to restore.

13.You can restore the system when DISK mode.

14.Go to layer1 , and the other layer will disappear.

Sample code Introduction

Do EWF Enable

DWORD CEWF::DoEwfEnable(LPCWSTR szProVolName,BOOL bReboot) 
{
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;
 
    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);

    EwfMgrEnable(hProVol);
	
    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();
 	
    return dwStatus;	
}

Do EWF Disable

DWORD CEWF::DoEwfDisable(LPCWSTR szProVolName , BOOL fCommit, BOOL bReboot) 
{	
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;

    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);

    EwfMgrDisable(hProVol,fCommit);

    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();

    return dwStatus;
}

Do EWF Commit

DWORD CEWF::DoEwfCommit (LPCWSTR szProVolName , BOOL bReboot) 
{
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;

    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);

    EwfMgrCommit(hProVol);
	    
    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();
	
    return dwStatus;
}

Do Set checkpoint

DWORD CEWF::DoEwfCheckPoint (LPCWSTR szProVolName, BOOL bReboot) 
{
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;
	
    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);

    EwfMgrCheckpoint(hProVol,L"Optional description");

    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();

    return dwStatus;
}

Do Restore

DWORD CEWF::DoEwfRestore(LPCWSTR szProVolName, BOOL bReboot) 
{
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;

    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);
	
    EwfMgrRestore(hProVol);
    
    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();
	
    return dwStatus;
}

Do EWF SetLevel

DWORD CEWF::DoEwfSetLevel(LPCWSTR szProVolName , BOOL bReboot) 
{
    DWORD dwStatus = ERROR_SUCCESS;
    HANDLE hProVol = INVALID_HANDLE_VALUE;
    BOOL bResult = FALSE;

    // Use the volume name to open a handle to this protected volume.
    hProVol = EwfMgrOpenProtected(szProVolName);

    EwfMgrSetLevel(
               hProVol,
               L"Optional Description",
               0,        // Level zero to be restored back to the protected volume.
               FALSE);   // Cannot delete the protected volumes data.
    // This command requires a reboot to take effect.
    if (bReboot) DoReboot();

    return dwStatus;
}

Retrieved from "http://tprd.info/lexwiki/index.php/EWF_Module"

Category: AllowPages

EWF Module

From LEXWiKi

Current revision

Contents

Why to use EWF?

How many modes does EWF has?

What's different about the modes?

The Sample code source you can download form

How to use the DEMO application

Sample code Introduction

Do EWF Enable

Do EWF Disable

Do EWF Commit

Do Set checkpoint

Do Restore

Do EWF SetLevel

Views

Personal tools

Navigation

分類(Object)

Search

Toolbox

@@ Line 1: / Line 1: @@
 [[Category:AllowPages]]
-== EWF Manager ==
+== Why to use EWF? ==
+Enhanced Write Filter (EWF) provides the ability to write-protect a run-time image. By redirecting all write requests to either a separate disk partition(Disk mode) or RAM(Ram-Reg mode).
+== How many modes does EWF has? ==
+There are Disk mode and Ram-Reg mode.
+== What's different about the modes? ==
+'''Ram-Reg mode''' works by clear all the write requests when reboot.
+.System will restore when reboot.
+.Doesn't need any other invisible partition.
+'''Disk mode''' works by the check point and restore.So Disk mode needs an invisible partition to save the write request of the check points.
+.Can set 9 check points.
+.Doesn't restore when reboot only if enter a restore commend.
+.Need an invisible partition in storage.
+.If you will do a big write request , ex:download some file , please disable the EWF first.
+   If the size of the write request is bigger than the size of the invisible partition. The WES will be crash.
+.There are no Disk mode in WES7.
 == The Sample code source you can download form ==
-Source file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/EWF/EWF_Manager_v1.5_Src.rar EWF_Manager_v1.5_Src.rar]
-Binary file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/EWF/EWF_Manager_v1.5_Bin.rar EWF_Manager_v1.5_Bin.rar]
+<Google Drive>
+Source file: [https://drive.google.com/file/d/1b1dxzxEu7E7prDQnOY2uxKDE6azr2FBC/view?usp=sharing EWF_Manager_Src_v1.5]
+Binary file: [https://drive.google.com/file/d/1Ut9oNVMGjV8bRdCYtloh-namnlroA3xq/view?usp=sharing EWF_Manager_Bin_v1.5]
+<FTP>
+Source file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/EWF/EWF_Manager_v1.5_Src.rar EWF_Manager_Src_v1.5]
+Binary file: [ftp://ftp.lex.com.tw/Engineer/SoftSupport/AP_Module/EWF/EWF_Manager_v1.5_Bin.rar EWF_Manager_Bin_v1.5]
 == How to use the DEMO application ==
@@ Line 17: / Line 46: @@
 .Disable EWF.
-.Commit EWF-Can do change on OS without reboot.When DISK mode,the layer will set to 1.
+.Commit EWF-In RAM-Reg mod:Can do change on OS without reboot.In DISK mode,the layer will set to 1.
 .Clear the command which you chose.
@@ Line 36: / Line 65: @@
 .Go to layer1 , and the other layer will disappear.
+== Sample code Introduction ==
+===Do EWF Enable===
+ DWORD CEWF::DoEwfEnable(LPCWSTR szProVolName,BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrEnable(hProVol);
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }
+===Do EWF Disable===
+ DWORD CEWF::DoEwfDisable(LPCWSTR szProVolName , BOOL fCommit, BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrDisable(hProVol,fCommit);
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }
+===Do EWF Commit===
+ DWORD CEWF::DoEwfCommit (LPCWSTR szProVolName , BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrCommit(hProVol);
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }
+===Do Set checkpoint===
+ DWORD CEWF::DoEwfCheckPoint (LPCWSTR szProVolName, BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrCheckpoint(hProVol,L"Optional description");
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }
+===Do Restore===
+ DWORD CEWF::DoEwfRestore(LPCWSTR szProVolName, BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrRestore(hProVol);
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }
+===Do EWF SetLevel===
+ DWORD CEWF::DoEwfSetLevel(LPCWSTR szProVolName , BOOL bReboot)
+ {
+     DWORD dwStatus = ERROR_SUCCESS;
+     HANDLE hProVol = INVALID_HANDLE_VALUE;
+     BOOL bResult = FALSE;
+     // Use the volume name to open a handle to this protected volume.
+     hProVol = EwfMgrOpenProtected(szProVolName);
+     EwfMgrSetLevel(
+                hProVol,
+                L"Optional Description",
+,        // Level zero to be restored back to the protected volume.
+                FALSE);   // Cannot delete the protected volumes data.
+     // This command requires a reboot to take effect.
+     if (bReboot) DoReboot();
+     return dwStatus;
+ }