March 2007 - Posts

Looking Forward to Window Clippings 2.0: Pop-ups

That’s right: I’m working on Window Clippings 2.0. This is another big release with many new features, much of which has been driven by user requests. I will be highlighting some of the new features over the next few weeks to give you an idea of what you can expect from version 2.0.

Take a look at the following image:

You guessed it, Window Clippings 2.0 supports pop-ups. You can now interact with the selected window to produce some effect, such as displaying a tool-tip or menu. Window Clippings will automatically determine the region including the popup windows and include it all in the final image. Now have a look at the same image in Photoshop:

If you look closely you’ll notice that even the alpha blending from the menu’s shadow has been captured. It may seem like a small thing but it’s the sort of thing that makes a screenshot look great!

Stay tuned for more highlights from the upcoming Window Clippings 2.0!


Version 1.5 is the current release and you can download it here.

© 2007 Kenny Kerr

Posted by KennyKerr with 8 comment(s)
Filed under:

AutoPtr Revisited

My AutoPtr class template, which I first published in my article entitled Mixing Native and Managed Types in C++ and then later updated for my MSDN article entitled Best Practices for Writing Efficient and Reliable Code with C++/CLI has turned into quite a popular class while at the same time generating some confusion or frustration.

Most of the trouble seems to come from my finalizer implementation where I insist on using an ASSERT to assure myself that the finalizer is never actually called. The assumption is that the AutoPtr instantiation will only be used internally and my code should never forget to dispose an object containing an AutoPtr. Of course readers have used my class in ways I had not anticipated and not surprisingly have complained that the assertion is firing when the GC calls the finalizer.

As I’ve said before, if you really don’t care about deterministic finalization then by all means go ahead and remove the assertion. It just means that you won’t know when you’re failing to dispose your objects, short of using a profiler or some other technique. Just be warned that relying on finalizers introduces all kinds of other problems so you’re on your own if you choose to rely on the GC to clean up your resources on a regular (irregular) basis.

Anyway, if you want to use the very latest version of AutoPtr you can find it here. This is basically version 3 of AutoPtr and adds some tweaks to previously published versions. Notably, it now throws ObjectDisposedException if you attempt to dereference the pointer. The assertion is still there in the finalizer but you’re free to comment it out if you really want to. Of course the ASSERT macro should be preprocessed to nothing in release builds, assuming your ASSERT macro is defined correctly, so it shouldn’t cause a problem for release builds that you may distribute.

© 2007 Kenny Kerr

Posted by KennyKerr with no comments

Balance CPU 1.0

Recently someone asked me what on earth the new QueryIdleProcessorCycleTime function in Windows Vista does. I can understand the confusion considering the documentation is just plain wrong, at least in terms of how the function is used. If you can look beyond the documentation then you will discover a function that is quite straightforward to use and actually quite interesting if you’re into performance and scalability. But first some background information.

Windows uses an interval timer to determine the time slices that the CPU allocates to different threads. These are absolute intervals that include time spent in the kernel servicing interrupts. On previous versions of Windows, the thread scheduler simply used these intervals to determine how much time each thread has been allotted even if a thread didn’t actually get its full slice due to interrupt processing and other factors. Well Windows Vista’s thread scheduler now takes advantage of the cycle counter register available on modern processors to accurately measure and provide the most accurate scheduling possible. Although Windows still uses interval-based scheduling, it can now more fairly determine whether a thread actually got to use a particular interval for any reasonable amount of time.

The QueryIdleProcessorCycleTime function, along with the QueryThreadCycleTime and QueryProcessCycleTime functions, provide applications with some insight into the number of cycles charged to different processes. In particular, QueryIdleProcessorCycleTime returns the number of cycles that each processor has spent idle. Think of this as the number of cycles consumed by each processor’s idle thread. As I mentioned, the QueryIdleProcessorCycleTime documentation is very misleading so here is a simple example illustrating how you might use it to display the number of clock cycles used by each processor’s idle thread.

SYSTEM_INFO info = { 0 };

CAtlArray<ULONG64> procs;

ULONG size = info.dwNumberOfProcessors * sizeof(ULONG64);


for (size_t index = 0; index < procs.GetCount(); ++index)
    ULONG64 idleCycles = procs[index];
    cout << "Processor " << index << ": " << idleCycles << endl;

As I hinted at before, this information can come in handy when trying to determine how effectively software is using the available processing power. Does your application effectively scale to multiple cores? Are some processors being “starved for attention” so to speak?

To allow me to visually inspect these characteristics I wrote the Balance CPU utility. Here is Balance CPU running on an Intel Core 2 Duo on Windows Vista.

Balance CPU provides a visual representation of the idle cycles for each processor. The bars are scaled to illustrate the relative differences in activity between processors. Shorter bars indicate more activity while longer bars indicate more time spent idle. A well balanced system will have all the bars roughly the same width while a system that does not scale well to the available processors will have an unbalanced set of processors with bars varying greatly in width.

You can also place the mouse pointer over a processor bar and a tool-tip will display the actual clock cycles for that processor.

Balance CPU also updates the display as well as the tool-tips every second so you can see how different applications and tasks make use of the available processing power. For fun, run my Max CPU utility side by side with Balance CPU and see how the clock cycles are burned up as you slide the stress level up and down.

The Balance and Reset buttons allow you to get a representation of clock cycles since a particular point in time. Say you want to see how well your application scales but don’t want previous idle cycles to bias the results. Simply click the Balance button and the processor bars will only present relative differences in activity since you clicked the Balance button. To reset the display simply click the Reset button.

Here is Balance CPU running on a Dual Intel Xeon with Hyper-Threading (4 logical processors) on Windows Server Longhorn with Max CPU to provide some imbalance.

Download the executable and save it to a local drive before running it. It requires Windows Vista or later and the .NET Framework 2.0 and will run natively as either a 32-bit or 64-bit process depending on your operating system.

© 2007 Kenny Kerr

Posted by KennyKerr with 1 comment(s)

XmlLite: A Small And Fast XML Parser For Native C++

Sorry for the lack of posts lately – I’ve been hard at work on various projects. In particular I’ve been working on a whole bunch of new articles that will be published throughout the year. The first of these is available now in the April 2007 issue of MSDN Magazine.

XmlLite: A Small And Fast XML Parser For Native C++

Despite the ongoing success of the .NET Framework, Microsoft is still serious about native C++ development. This is demonstrated by the introduction of XmlLite, a high-performance, low-overhead XML reader and writer geared for applications written in native C++.


Update: I’m getting a lot of email about XmlLite so here are the links you need in order to get going:

Download and install the latest Windows SDK, which provides the XmlLite header and lib files needed to compile and link. Although this is the SDK for Windows Vista, it also supports targeting Windows XP and Windows 2003.

If you don’t already have it, download and install XmlLite. This is only required for Windows XP x86 installations that haven’t already received it from Windows Update or some other means.

© 2007 Kenny Kerr

Posted by KennyKerr with 14 comment(s)
More Posts