请求执行时间段与Shell函数

核心提示：请求执行时间段通常被简称为"appy time"，是指当系统VM稳定到充许VxDs和ring-3级别的应用软件（特别是16-bit的应用软件）交互时的时间段，请求执行时间段与Shell函数，例如，在一个特定时间段，结构与字符串之间的距离是结构本身的大小，32字节（20h），VxDs能加载并调用在16

请求执行时间段通常被简称为"appy time"。是指当系统VM稳定到充许VxDs和ring-3级别的应用软件（特别是16-bit的应用软件）交互时的时间段。例如，在一个特定时间段，VxDs能加载并调用在16-bit Dlls中的函数。这个appy time在Windows 3.x中是无效的。在Windows3.x，一个VxD能包含在16-bit DLLs中的任意函数的地址，并模拟一个远调用到这个地址。然而，因为造成了VMM重入，这个操作将中断所有正在ring-3中执行的任务。所以能被VxDs能调用的APIs被要求是中断安全的，象PostMessage。在Windows 95，一个VxD在appy time的帮助下能调用任意一个在16-bit DLLs中的函数。

假如你的VxDs被通知正处在appy time，它就能加载16-bit DLLs并调用其中的函数。VxDs怎么知道appy time到来了呢？这就要使用Shell VxD请求一个appy time。当系统VM在稳定状态，Shell VxD将调用某VxD的一个回调函数，此函数是在VxD请求appy time时指定的。Shell VxD发生一次appy time事件仅仅调用一次你的回调函数。这就象找工作。你到职业介绍所，登记你的名字和电话号码。当你回到家，如有一个工作适合你，职业介绍所将电话通知你这个好消息。当你收到了这个消息，他们就不再通知你了。

在一个appy time起作用前要花上一些时间进行相关处理。appy time事件以下环境中将不起作用：

1、系统启动或关机时。

2、当系统VM在临界段或等待一个信号量时。

管理一个appy time事件

你可以通过调用_SHELL_CallAtAppyTime来注册一个appy time事件，它的定义如下：

VxDCall _SHELL_CallAtAppyTime, <<OFFSET32 pfnCallback>, dwRefData, dwFlags, dwTimeout>

pfnCallBack -- 当appy time事件发生时你要Shell VxD调用的回调函数的平板地址。这个函数接收两个参数，dwRefData和dwFlags，与你传送给_SHELL_CallAtAppyTime的两个一样。记住，Shell VxD采用C调用顺序调用你的回调函数。总而言之，你要象这样定义你的回调函数：
　　 BeginProc OnAppyTime, CCALL, PUBLIC

ArgVar dwRefData,DWORD ; declare argument name and type

ArgVar dwFlags, DWORD

EnterProc

你的代码...

LeaveProc

Return

EndProc OnAppyTime

dwRefData -- 你要Shell VxD传送给你的回调函数的参考数据。可以是你想要的任何东西。

dwFlags -- 事件标志。

如下值之一：

CAAFL_RING0 ring-0事件

CAAFL_TIMEOUT 由dwTimeout指定的时间到期事件。

假如你只想在一定的时间内等待appy time事件，使用CAAFL_TIMEOUT标志。如你想一直等待appy time事件，使用NULL。CAAFL_RING0作用不明。

dwTimeout -- 在appy time事件发生前，VxD能等待时间段长度。时间段的单位不明。

这个服务是异步的，意味着你为appy time事件注册回调函数之后立即返回。

如果这个服务调用是成功的，在eax中返回appy time事件句柄。假如调用失败，在eax返回0。

你可以调用_SHELL_CancelAppyTimeEvent来撤消appy time事件注册，它仅有一个参数，就是由_SHELL_CallAtAppyTime返回的appy time事件句柄。

你应当在appy time事件到来时检查系统。例如，当你在系统关闭时注册appy time会发生什么？你的VxD的回调函数将不会得到调用！当appy time事件到来时，你应当调用_SHELL_QueryAppyTimeAvailable来查询系统状态。这个服务没有参数。如果appy time无效，在eax中返回0，例如：当系统关闭时或消息服务程序产生一个一般保护性错误时。

这个服务不会告诉你现在是不是appy time：它仅仅告诉你可能有一个appy time事件到来。简而言之，如果你想安全运行，首先调用_SHELL_QueryAppyTimeAvailable并检查eax中的值是否非零值，然后才可继续调用_SHELL_CallAtAppyTime。

当appy time到达时，你可以使用几个Shell服务调用：

_SHELL_CallDll
_SHELL_FreeLibrary
_SHELL_GetProcAddress
_SHELL_LoadLibrary
_SHELL_LocalAllocEx
_SHELL_LocalFree

使用提供的这6个服务，VxDs可以调用在16-bit DLLs/EXE中的16-bit函数，象WinHelp。然而，我们马上要进步到32-bit时代（未来是64-bit） ，所以我不会仔细研究它们。如你对此感兴趣，你可以在Windows 95/98DDK文档中了解它们。

另外一些只请求执行时间段服务我想更有用处：_SHELL_ShellExecute和 _SHELL_BroadcastSystemMessage。使用_SHELL_BroadcastSystemMessage，你能在一次调用中发送消息到顶端的窗口和所有的VxDs。如果appy time有效，你可以发送消息到窗口和VxDs。如果appy time无效，你只能发送消息到VxDs。

_SHELL_ShellExecute是在ring-3中的函数ShellExecute在ring-0中的对应函数。实际上，它调用ring-3中的ShellExecute完成这个工作。使用外壳服务，你可以运行/打开/打印任意文件。

_SHELL_ShellExecute的定义如下所示：

VxDCall _SHELL_ShellExecute,<OFFSET32 ShexPacket>

它仅有一个参数，SHEXPACKET结构的平板地址。它从ShellExecute函数中返回一个值到eax中。让我们研究一下SHEXPACKET结构：

shex_dwTotalSize SHEXPACKET结构的字节数加上可选的参数rgchBaggage的大小，它直接跟随在这个结构之后。我等一下描述rgchBaggage。

shex_dwTotalSize SHEXPACKET结构的字节数加上可选的参数rgchBaggage的大小，它直接跟随在这个结构之后。我等一下描述rgchBaggage。

shex_dwSize SHEXPACKET结构的字节数，不包括rgchBaggage。结合上面的shex_dwTotalSize值，外壳VxD能计算任意长度的rgchBaggage的大小。

shex_ibOp 你要完成的操作。假如你指定0，意味着你想要打开一个文件。如果是一个可执行文件，就运行它。如果你想要完成其他的操作，你必须在rgchBaggage中指定操作的名字，在这个域中，必须包括从这个SHEXPACKET结构开始到一个ASCII字符串的距离，此距离大小以字节计数，字符串指定你要完成的操作的名称。SHEXPACKET结构的大小是32字节。如果操作字符串紧跟在SHEXPACKET结构后，shex_ibOp中的值必须是32。要知道你可以完成的操作，请查看ShellExecute服务。有三个操作被定义，"open"、"print"和"explore"。

shex_ibFile 从此结构开始到一个ASCII字符串的距离，这个字符串是你想要传递给ShellExecute的文件名，就象Shex_ibOp成员。

shex_ibParams 你想传递到由shex_ibFile指定的文件的可选参数。假如此文件是一个文档文件，你不想传递任何参数给它，就用0。假如你想传递参数给那个文件，在把从此结构开始到此成员指定的字符串的距离放在这个成员中。简而言之，就象shex_ibOp和shex_ibFile成员。

shex_ibDir 工作目录。假如你想使用Windows目录就指定0，否则指定其为在此结构后的首选目录名字符串，并把从此结构开始到目录名字符串的距离值放到这个成员中。

shex_dwReserved 如其名字所指，它是保留的。不要理它。

shex_nCmdShow 应用程序窗口怎样被显示。这是一个你正常传递给ShowWindow的值，比如，SW_XXXX值。可在windows.inc中查看这些值。

所有成员的大小都是双字的。在这里我介绍刚才我承诺的rgchBaggage成员。仅有一点不同，因为其大小是可变的，所以它作为SHEXPACKET结构的一员却不能包括在此结构的定义中。查看shell.inc，你看到rgchBaggage并不在SHEXPACKET结构的定义中，尽管在Windows 9x DDK文档中，声明其是SHEXPACKET结构的一员。
　　 rgchBaggage是什么？简单说来其是跟在SHEXPACKET结构后的一个字符串数组。在这个数组中，你可以把你要对文件完成的操作名称、文件的名字、你要传递给文件的参数和工作目录放在其中。首先得到从SHEXPACKET结构到这些字符串的第一个字符之间的距离（即此结构的一些成员值），再把这些值加上SHEXPACKET结构的平板编移量，Shell VxD就能得到这些字符串在rgchBaggage数组中的偏移量。例如，假如SHEXPACKET结构从60000h开始，字符串紧跟其后，结构与字符串之间的距离是结构本身的大小，32字节（20h）。所以Shell VxD知道字符串定位在60020h。