(转)驱动开发之五 --- TDI之八【译文】

新源译码

于 2015-11-10 14:19:24 发布

阅读量461

点赞数

分类专栏：驱动

驱动专栏收录该内容

13 篇文章 0 订阅

订阅专栏

http://hi.baidu.com/combojiang/item/fe7ee5147f64a621f6625c0e

步骤8：关闭句柄
这个函数被两个句柄调用，传输句柄和上下文句柄。

NTSTATUS TdiFuncs_CloseTdiOpenHandle(HANDLE hTdiHandle,

PFILE_OBJECT pfoTdiFileObject)

{

NTSTATUS NtStatus = STATUS_SUCCESS;

* De-Reference the FILE_OBJECT and Close The Handle

ObDereferenceObject(pfoTdiFileObject);

ZwClose(hTdiHandle);

return NtStatus;

}

其他资源

一旦你熟悉了，TDI接口就变得简单了。当写驱动时，最大的事情就是处理IRP。TDI似乎比socket有些复杂，但是它是内核接口。

如果曾经研究过TDI或者NDIS,你大概进入过Thomas Divine. 如果你想购买复杂的TDI或者NDIS示例，你可以找他们，或者他公司网站上的其他资源。在上面你也可以找到其他不同网站的指南。

IRP处理

下篇文章将粗微的谈到一些IRP的基本概念和怎样处理他们。实际上那里描述的东西有一些大的缝隙，为了保持下篇文章简单，所以在本篇我们将加快步伐，尽可能多的去填充这些缝隙。在这时，正面的揭示这些给驱动开发者，我们能非常简单的做这个。然而这里有大量的信息，并不是所有的都在示例代码中体现出来了。你需要自己试验这些IRP的处理，这是开发驱动的根本部分。

驱动请求

当写驱动的时候，有两次不同的揭示IRP. 即：发给你自己驱动的请求和你创建的IRP,发送给在其他驱动的请求两种。我记得，有一个驱动栈，栈里的每一个驱动在IRP中都有自己的栈区域。每次一个IRP沿着栈向下发送，IRP的当前栈区域是优先的。当它到达你的驱动时，你可以有少量的选择。

前进和遗忘

你可以使用IoCallDriver使IRP向前到栈中的下一个驱动。这是我们在其它驱动指南中的做法。我们向前了IRP并且忘记它。可是这里有一个问题，我们并没有考虑到STATUS_PENDING的情况。STATUS_PENDING是实现异步操作的一个方法。由底层驱动通知调用者，他们没有完成这个IRP。或许他们也正在一个单独的线程中完成这个IRP. 它的规则是如果你返回STATUS_PENDING，你必须在返回之前调用IoMarkIrpPending。如果你已经向前把IRP传给了下一个驱动，现在这仍然是个问题。在调用后，不允许你接触它。所以实际上你有两个选择。

IoMarkIrpPending(Irp);

IoCallDriver(pDeviceObject, Irp);

return STATUS_PENDING;

第二个选择是设置一个完成例程。你应该记得在第四篇文章中的代码，我们使用完成例程通过返回STATUS_MORE_PROCESSING_REQUIRED而不是STATUS_SUCCESS，停止了一个IRP的完成。,

IoSetCompletionRoutine(Irp, CompletionRoutine, NULL, TRUE, TRUE, TRUE);

return IoCallDriver(pDeviceObject, Irp);

...

NTSTATUS CompletionRoutine(PDEVICE_OBJECT DeviceObject,

PIRP Irp, PVOID Context)

{

if(Irp->PendingReturned)

{

IoMarkIrpPending(Irp);

}

return STATUS_SUCCESS;

}

你可以在这里再一次的停止处理过程，如果你这么做，你需要使用IoMarkIrpPending。这里有个循环逻辑，如果你调用IoMarkIrpPending，那么你必须从你的驱动中返回STATUS_PENDING，如果你从你的驱动中返回STATUS_PENDING，你必须调用IoMarkIrpPending。记住，如果你停止一个完成的处理，那么这就意味着你必须完成它。我们在第四篇就是这么做的。

需要注意一点，如果一个完成例程不提供这些，I/O管理器会把"IoMarkIrpPending"告诉给你。在这个或许你不想去相信的主题中，无论信息是多么分散，你要确信你所做的任何事情都是对的。

向前和投递处理

这和我们在第四篇的处理有些细微的差别。我们需要考虑pending的情况，如果IRP从底层驱动中返回pending的状态，我们需要等待，直到底层驱动完成它。一旦驱动完成，我们需要唤醒原始线程，这样我们就可以处理和完成IRP. 作为一个最佳方式，如果pending状态返回，我们只想设置事件。如果任何事情被同步处理，就不需要增加前面的设置和等待事件。下面是代码示例。

IoSetCompletionRoutine(Irp, CompletionRoutine,

&kCompleteEvent, TRUE, TRUE, TRUE);

NtStatus = IoCallDriver(pDeviceObject, Irp);

if(NtStatus == STATUS_PENDING)

{

KeWaitForSingleObject(&kCompleteEvent,

Executive, KernelMode, FALSE, NULL);

* Find the Status of the completed IRP

NtStatus = IoStatusBlock.Status;

}

* Do Post Processing

IoCompleteRequest(pIrp, IO_NO_INCREMENT);