Skip to main content

Crate rdi_platform_windows

Crate rdi_platform_windows 

Source
Expand description

Windows Shell/COM backend for rusty-desktop-icons.

This crate provides WindowsBackend, the concrete rdi_core::DesktopBackend driving the real Windows desktop through IFolderView2. Everything unsafe lives here — rdi-core itself forbids unsafe_code.

§Usage

use rdi_core::DesktopController;
use rdi_platform_windows::WindowsBackend;

let ctrl = DesktopController::new(WindowsBackend::new())?;
let icons = ctrl.list_icons()?;
println!("{} icons on the desktop", icons.len());

§Threading

WindowsBackend initialises COM (STA) lazily on the thread that first calls a DesktopBackend method, which — under normal use — is the engine’s dedicated worker thread. Do not construct two backends on the same thread.

§Modules

  • ids — hex-encoded UTF-16 identifier scheme (compatible with the legacy Python extension).
  • com — IFolderView2 acquisition and caching (crate-private).
  • pidl — RAII wrappers for shell-allocated memory (crate-private).
  • backend — WindowsBackend itself (crate-private module, type re-exported).

Modules§

ids
Icon identifier encoding.
shader
Runtime HLSL compilation for the Windows sprite renderer.
shader_library
Built-in shader bodies, default stages and shared pipeline HLSL.

Structs§

WindowsBackend
Windows-native DesktopBackend driving Explorer’s desktop folder view.

Enums§

FolderFlag
A Windows folder-view flag or an arbitrary raw mask (R-FLAG-2).