Edit

Share via

FSCTL_TXFS_WRITE_BACKUP_INFORMATION IOCTL (winioctl.h)

  • Article

Note

Microsoft strongly recommends developers utilize alternative means to achieve your application’s needs. Many scenarios that TxF was developed for can be achieved through simpler and more readily available techniques. Furthermore, TxF may not be available in future versions of Microsoft Windows. For more information, and alternatives to TxF, please see Alternatives to using Transactional NTFS.

Writes Transactional NTFS (TxF) specific information to a specified file. The Buffer member of the TXFS_WRITE_BACKUP_INFORMATION structure must be the Buffer member of the TXFS_READ_BACKUP_INFORMATION_OUT structure returned by FSCTL_TXFS_READ_BACKUP_INFORMATION.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                     // handle to device
  FSCTL_TXFS_WRITE_BACKUP_INFORMATION,  // dwIoControlCode
  (LPVOID) lpInBuffer,                  // input buffer
  (DWORD) nInBufferSize,                // size of input buffer
  NULL,                                 // lpOutBuffer
  0,                                    // nOutBufferSize
  (LPDWORD) lpBytesReturned,            // number of bytes returned
  NULL                                  // OVERLAPPED structure
);

Remarks

FSCTL_TXFS_WRITE_BACKUP_INFORMATION is a synchronous operation.

This control code can be used by backup functions and applications, such as Win32 BackupRead, and by Volume Snapshot Service (VSS) writers that support secondary resource managers. For more information, see Volume Shadow Copy Service.

ReFS:  This code is not supported.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header winioctl.h (include Windows.h)

See also