網(wǎng)絡(luò)驅(qū)動(dòng)程序編程要點(diǎn)

編寫Windows 2000的任何網(wǎng)絡(luò)驅(qū)動(dòng)程序時(shí)通常都需要考慮的幾點(diǎn)問(wèn)題

1 可移植性

2 多處理器支持

3 IRQLs

4 同步和指示

5 包結(jié)構(gòu)

6 使用共享內(nèi)存

7 異步I/O和完成函數(shù)

1. 可移植性

NDIS驅(qū)動(dòng)程序應(yīng)很容易在支持Windows 2000的平臺(tái)間移植。一般說(shuō)來(lái)，從一個(gè)硬件平臺(tái)移植到另一個(gè)平臺(tái)只需要將它在兼容系統(tǒng)的編譯中重新編譯即何。

驅(qū)動(dòng)程序開(kāi)發(fā)者應(yīng)當(dāng)避免調(diào)用與操作系統(tǒng)相關(guān)的函數(shù)，因?yàn)檫@將使他們的驅(qū)動(dòng)程序不可移植。應(yīng)用NDIS函數(shù)替換這些調(diào)用，只調(diào)用NDIS函數(shù)將使代碼在支持NDIS的微軟操作系統(tǒng)中可移植，NDIS為編寫驅(qū)動(dòng)程序提供了很多支持函數(shù)，并且直接調(diào)用操作系統(tǒng)是不需要的。

驅(qū)動(dòng)程序應(yīng)用C來(lái)編寫。更近一步，驅(qū)動(dòng)程序代碼應(yīng)當(dāng)限制在ANSI C標(biāo)準(zhǔn)并且應(yīng)當(dāng)避免使用不被其他兼容系統(tǒng)編譯器支持的語(yǔ)言特性。驅(qū)動(dòng)程序代碼編寫不應(yīng)當(dāng)使用任何ANSI C標(biāo)準(zhǔn)指明為“implementation defined”的特性來(lái)編寫。

驅(qū)動(dòng)程序應(yīng)當(dāng)避免使用任何在不同平臺(tái)上大小和結(jié)構(gòu)變化的數(shù)據(jù)類型，驅(qū)動(dòng)程序代碼不應(yīng)該調(diào)用任何C的運(yùn)行時(shí)庫(kù)函數(shù)，而是限于調(diào)用NDIS提供的函數(shù)。

在內(nèi)核模式下漂移指針是不允許的。試圖運(yùn)行這樣的操作將是一個(gè)致命的錯(cuò)誤。

如果驅(qū)動(dòng)程序代碼要支持特殊平臺(tái)的特性，那么這些代碼應(yīng)當(dāng)包含在#ifdef和#endif聲明之間。

2. 多處理器支持

編寫的代碼應(yīng)當(dāng)可以在多處理器系統(tǒng)中安全運(yùn)行。這對(duì)于編寫可移植的Windows 2000驅(qū)動(dòng)程序是很重要的。一個(gè)網(wǎng)絡(luò)驅(qū)動(dòng)程序必須使用NDIS函數(shù)庫(kù)提供的多處理器安全保證。

在單處理器環(huán)境下，在一個(gè)時(shí)刻單處理器只運(yùn)行一條機(jī)器指令，既使這樣，當(dāng)包到達(dá)或時(shí)間中斷發(fā)生時(shí)，對(duì)于NIC或其他設(shè)備執(zhí)行的中斷也可能發(fā)生。典型的，當(dāng)正在操縱數(shù)據(jù)結(jié)構(gòu)時(shí)，例如它的隊(duì)列時(shí)，驅(qū)動(dòng)程序?qū)?span lang=EN-US>NIC發(fā)出停用中斷來(lái)操縱數(shù)據(jù)，隨后再發(fā)生可用中斷。許多線程在單處理器環(huán)境下表現(xiàn)的好像是在同一時(shí)刻運(yùn)行的，但是實(shí)際上它們卻是在獨(dú)立的時(shí)間片上運(yùn)行的。

在多處理器環(huán)境下，處理器同時(shí)可運(yùn)行多條機(jī)器指令，一個(gè)驅(qū)動(dòng)程序必須異步化，這使得當(dāng)一個(gè)驅(qū)動(dòng)程序函數(shù)正在操縱一個(gè)數(shù)據(jù)結(jié)構(gòu)時(shí)，同樣的在其他處理器運(yùn)行的驅(qū)動(dòng)程序函數(shù)不能修改共享的數(shù)據(jù)。在一個(gè)SMP機(jī)器中，所有的驅(qū)動(dòng)程序代碼都要重新裝入，為了消除這種資源保護(hù)問(wèn)題，Windows 2000驅(qū)動(dòng)程序使用自旋鎖。

3. IRQL

所有NDIS調(diào)用的驅(qū)動(dòng)程序函數(shù)都運(yùn)行在系統(tǒng)決定的IRQL下， PASSIVE_LEVEL<DLSPATCH_LEVEL<DIRQL中的一個(gè)。例如，一個(gè)微端口初始化函數(shù)、掛起函數(shù)、重啟函數(shù)和有時(shí)的關(guān)閉函數(shù)通常都運(yùn)行在PASSIVE_LEVEL下。中斷代碼運(yùn)行在DIRQL下，所以NDIS中層或協(xié)議驅(qū)動(dòng)程序從不運(yùn)行在DIRQL下。所有其他的NDIS驅(qū)動(dòng)程序函數(shù)運(yùn)行在IRQL<=DISPATCH_LEVEL下。

驅(qū)動(dòng)程序函數(shù)運(yùn)行于的IRQL將影響調(diào)用什么樣的NDIS函數(shù)。特定的函數(shù)只可在IRQL PASSIVE_LEVEL下調(diào)用，其他的函數(shù)可在DISPATCH_LEVEL或更低層調(diào)用。一個(gè)驅(qū)動(dòng)程序的編寫者應(yīng)當(dāng)檢查每一個(gè)NDIS函數(shù)的IRQL限制。

任何與驅(qū)動(dòng)程序的ISR共享資源的驅(qū)動(dòng)程序函數(shù)必須能將它的IRQL升級(jí)到DTRQL來(lái)防止?fàn)幱们闆r的發(fā)生，NDIS提供了這種機(jī)質(zhì)。

4. 同步和指示

當(dāng)兩個(gè)線程共享可被同時(shí)訪問(wèn)的資源時(shí)，無(wú)論是單處理機(jī)還是SMP，同步是必須的。例如，對(duì)于一個(gè)單處理機(jī)，如果一個(gè)驅(qū)動(dòng)程序正在訪問(wèn)一個(gè)共享資源時(shí)，被一個(gè)運(yùn)行在更高IRQL（例如ISR）的函數(shù)中斷時(shí)，必須保護(hù)共享資源以阻止這種爭(zhēng)用的發(fā)生而使資源處于不確定狀態(tài)。在一個(gè)SMP中，兩個(gè)線程可以在同一時(shí)刻運(yùn)行，在不同處理器上并且試圖來(lái)修改同一數(shù)據(jù)的訪問(wèn)必須同步。

NDIS提供了自旋鎖可以用來(lái)對(duì)在同一IRQL下運(yùn)行的線程間訪問(wèn)共享資源實(shí)現(xiàn)同步。當(dāng)兩個(gè)線程在不同IRQL下訪問(wèn)共享資源時(shí)，NDIS提供了一種機(jī)制來(lái)臨時(shí)提高低IRQL代碼的IRQL，以使得訪問(wèn)共享資源串行化。

    NDIS提供下面四種機(jī)制來(lái)保證同步：

自旋鎖

自旋鎖提供了一個(gè)用來(lái)保護(hù)共享資源的同步機(jī)制，這種資源是單處理器或一個(gè)多處理機(jī)下的、運(yùn)行在IRQL>PASSIVE_LEVEL下的、內(nèi)核模式中的線程所共享使用的。一個(gè)自旋鎖在同時(shí)運(yùn)行在一個(gè)SMP機(jī)上不同的執(zhí)行線程之間提供同步。一個(gè)線程在訪問(wèn)保護(hù)資源前獲得一個(gè)自旋鎖。自旋鎖使得任務(wù)線程中只有持有自旋鎖的線程可使用資源。一個(gè)等待自旋鎖的線程將在試圖獲得鎖時(shí)間內(nèi)循環(huán)，直到持有鎖的線程釋放為止。

    自旋鎖還存在著一個(gè)不太明顯但很重要的事實(shí)：你僅能在低于或等于DISPATCH_LEVEL級(jí)上請(qǐng)求自旋鎖，在你擁有自旋鎖期間，內(nèi)核將把你的代碼提升到DISPATCH_LEVEL級(jí)上運(yùn)行。在內(nèi)部，內(nèi)核能在高于DISPATCH_LEVEL的級(jí)上獲取自旋鎖，但你和我都做不到這一點(diǎn)。當(dāng)KeAcquireSpinLock獲取自旋鎖時(shí)，它會(huì)把IRQL提升到DISPATCH_LEVEL級(jí)上。當(dāng)KeReleaseSpinLock釋放自旋鎖時(shí)，它會(huì)把IRQL降低到原來(lái)的IRQL級(jí)上。如果你知道代碼已經(jīng)處在DISPATCH_LEVEL級(jí)上，你可以調(diào)用兩個(gè)專用函數(shù)來(lái)獲取自旋鎖。KeAcquireSpinLockAtDpcLevel及 KeReleaseSpinLockFromDpcLevel。一個(gè)編寫很好的網(wǎng)絡(luò)驅(qū)動(dòng)程序應(yīng)該會(huì)減少自旋鎖持有的時(shí)間。

    一個(gè)典型的使用自旋鎖的例子是保護(hù)一個(gè)隊(duì)列。例如，微端口發(fā)送函數(shù)MiniportSend將協(xié)議驅(qū)動(dòng)程序傳來(lái)的包進(jìn)行排隊(duì)。因?yàn)槠渌?qū)動(dòng)程序函數(shù)也使用這個(gè)隊(duì)列，MiniportSend必須用一個(gè)自旋鎖保護(hù)這個(gè)隊(duì)列使得在一個(gè)時(shí)刻只有一個(gè)線程可操縱這個(gè)隊(duì)列。Miniport Send獲得自旋鎖，添加包到隊(duì)列后釋放自旋鎖。使用自旋鎖保證持鎖線程是唯一修改隊(duì)列的線程，同時(shí)使得包被安全地添加到隊(duì)列中。當(dāng)NIC驅(qū)動(dòng)程序從隊(duì)列中取走包時(shí)，通過(guò)同樣的自旋鎖保護(hù)這個(gè)訪問(wèn)。當(dāng)執(zhí)行指令修改隊(duì)列頭或任何隊(duì)列組成域時(shí)，驅(qū)動(dòng)程序必須用自旋鎖保護(hù)隊(duì)列。

避免死鎖問(wèn)題

Windows 2000并不限制網(wǎng)絡(luò)驅(qū)動(dòng)程序同時(shí)持有多于一個(gè)的自旋鎖。但是，驅(qū)動(dòng)程序的某部分在持有自旋鎖B時(shí)，試圖獲得自旋鎖A，并且其他部分在持有鎖A時(shí)，試圖獲得自旋鎖B時(shí)，死鎖就會(huì)發(fā)生。如果要獲得多于一個(gè)的自旋鎖，驅(qū)動(dòng)程序應(yīng)當(dāng)通過(guò)強(qiáng)制以某一順序獲得鎖來(lái)避免死鎖，這就是說(shuō)，如果一個(gè)驅(qū)動(dòng)程序強(qiáng)制在獲得自旋鎖A之后才可獲得鎖B，那么上述情況就不會(huì)發(fā)生。

總得來(lái)說(shuō)，使用自旋鎖將對(duì)系統(tǒng)性能帶來(lái)負(fù)面效應(yīng)，所以驅(qū)動(dòng)程序不應(yīng)當(dāng)使用許多鎖。

時(shí)鐘

時(shí)鐘被用來(lái)輪詢或進(jìn)行超時(shí)操作的。一個(gè)驅(qū)動(dòng)程序可以產(chǎn)生一個(gè)時(shí)鐘并與一個(gè)函數(shù)關(guān)聯(lián)上。當(dāng)一個(gè)特定周期時(shí)鐘期滿時(shí)，調(diào)用相關(guān)函數(shù)。時(shí)鐘可以是一次的或周期性的，一但設(shè)置了一個(gè)周期時(shí)鐘，當(dāng)每個(gè)周期結(jié)束時(shí)都會(huì)觸發(fā)，直到它被完全清除掉為止。一次性時(shí)鐘在觸發(fā)后必須重新設(shè)置。

時(shí)鐘通過(guò)調(diào)用NdisMInitializeTimer來(lái)產(chǎn)生和初始化，并且通過(guò)調(diào)用NdisMsetTimer來(lái)設(shè)置，也可調(diào)用NdisMsetPeriodicTimer設(shè)置周期時(shí)鐘。如果使用了一個(gè)非周期時(shí)鐘，那么通過(guò)調(diào)用NdisMSetPeriodicTimer重新設(shè)置時(shí)鐘。通過(guò)調(diào)用NdisMCancelTimer可以清除時(shí)鐘。

事件

事件在兩個(gè)執(zhí)行線程之間實(shí)現(xiàn)同步操作。一個(gè)事件通過(guò)一個(gè)驅(qū)動(dòng)程序裝入并且通過(guò)調(diào)用NdisInitializeEvent初始化。一個(gè)運(yùn)行在IRQL PASSIVE_LEVEL下的線程調(diào)用NdisWaitEvent來(lái)將自身轉(zhuǎn)入等侯狀態(tài)。當(dāng)一個(gè)驅(qū)動(dòng)程序線程等待一個(gè)事件時(shí)，它指定了最大等待時(shí)間即等待事件的時(shí)間。當(dāng)調(diào)用NdisSetEvent使時(shí)間得到信號(hào)量，或最大等待時(shí)間段結(jié)束時(shí)，它們兩個(gè)無(wú)論是誰(shuí)先發(fā)生時(shí)都將結(jié)束線程等待狀態(tài)。

典型的，事件是通過(guò)相互協(xié)調(diào)的線程調(diào)用NdisSetEvent來(lái)設(shè)置的。事件被創(chuàng)建時(shí)是沒(méi)有信號(hào)量的，但為了指示等待線程，它必須要設(shè)置信號(hào)量，事件將一直處于保持有信號(hào)狀態(tài)，直到NdiResetEvent調(diào)用后為止。

5. 包結(jié)構(gòu)

通過(guò)一個(gè)協(xié)議驅(qū)動(dòng)程序可以分配NDIS包、填充數(shù)據(jù)，并且將它傳遞到下層的NDIS驅(qū)動(dòng)程序，以便將數(shù)據(jù)發(fā)送到網(wǎng)絡(luò)上。一些最底層的NIC驅(qū)動(dòng)程序分配包用來(lái)保存接收到的數(shù)據(jù)，并將包傳遞到對(duì)應(yīng)的高層驅(qū)動(dòng)程序。有時(shí)，一個(gè)協(xié)議驅(qū)動(dòng)程序分配一個(gè)包，并且通過(guò)一個(gè)請(qǐng)求將它傳給NIC驅(qū)動(dòng)程序，以使NIC驅(qū)動(dòng)程序?qū)⒔邮盏降臄?shù)據(jù)拷貝到提供的包中。NDIS提供函數(shù)用來(lái)分配和操縱構(gòu)成包的子結(jié)構(gòu)。

包描述符 Flags：physicallPageCount： ToralLenth：FirstBuffer：P …

緩存描述符： StartVirtualAddress：P ByteOffset ByteCount PhysicalPage［］ Next P....

緩存

緩存描述符： StartVirtualAddress：P ByteOffset ByteCount PhysicalPage［］ Next P....

虛擬內(nèi)存

虛擬頁(yè)

虛擬頁(yè)

虛擬頁(yè)

虛擬頁(yè)

虛擬頁(yè)

物理內(nèi)存

物理頁(yè)

物理頁(yè)

物理頁(yè)

物理頁(yè)

物理頁(yè)

圖1：NDIS包結(jié)構(gòu)

具體詳情可以參考：http://www.ndis.com/papers/ndispacket/ndispacket1.htm

6. 使用共享內(nèi)存

    用作總線管理DMA設(shè)備的微端口驅(qū)動(dòng)程序必須為NIC和NIC驅(qū)動(dòng)程序分配共享內(nèi)存。當(dāng)在一個(gè)驅(qū)動(dòng)程序和它的NIC之間共享cache時(shí)，特別的預(yù)防是必須的。在某種結(jié)構(gòu)下，必須采取特別步驟來(lái)保證內(nèi)存一致，因?yàn)?span lang=EN-US>NIC可以直接訪問(wèn)共享的物理內(nèi)存，而NIC驅(qū)動(dòng)程序卻要通過(guò)cache訪問(wèn)內(nèi)存。這就引起驅(qū)動(dòng)程序和NIC訪問(wèn)內(nèi)存的不同，即使它們看起來(lái)在同一位置。

7. 異步I/O和完成函數(shù)

因?yàn)樵谝恍┚W(wǎng)絡(luò)操作中有繼承的因素，許多由NIC驅(qū)動(dòng)程序提供的上層函數(shù)和協(xié)議驅(qū)動(dòng)程序提供的下層函數(shù)被設(shè)計(jì)成支持異步操作，而不是用CPU消耗一定時(shí)間的循環(huán)來(lái)等待一個(gè)任務(wù)的完成或硬件事件的指示，網(wǎng)絡(luò)驅(qū)動(dòng)程序依賴處理許多異步操作的能力。

通過(guò)使用完成函數(shù)來(lái)支持異步網(wǎng)絡(luò)I/O。以下的例子將說(shuō)明網(wǎng)絡(luò)的send操作如何使用一個(gè)完成函數(shù)，同樣的機(jī)制也存在一個(gè)協(xié)議或NIC驅(qū)動(dòng)程序的其他操作中。

當(dāng)協(xié)議驅(qū)動(dòng)程序調(diào)用NDIS發(fā)送一個(gè)包時(shí)，NDIS調(diào)用NIC驅(qū)動(dòng)程序的MiniportSend函數(shù)發(fā)送請(qǐng)求，NIC驅(qū)動(dòng)程序試圖立即完成這個(gè)請(qǐng)求并且返回一個(gè)恰當(dāng)?shù)臓顟B(tài)值。對(duì)于同步操作，可能返回NDIS_STATUS_SUCCESS作為發(fā)送成功的標(biāo)志，NDIS_STATUS_RESOURCES和NDIS_STATUS_FAILURE表明有某些失敗。

但是一個(gè)發(fā)送操作要花費(fèi)一些時(shí)間來(lái)完成，此時(shí)NIC驅(qū)動(dòng)程序(或NDIS)可將包排隊(duì)并且等侯NIC指示發(fā)送操作的結(jié)果。NIC驅(qū)動(dòng)程序的MiniportSend函數(shù)可以通過(guò)返回一個(gè)NDIS_STATUS_PENDING的狀態(tài)值來(lái)異步處理這個(gè)操作，當(dāng)NIC驅(qū)動(dòng)程序完成了發(fā)送操作后，包調(diào)用完成函數(shù)NdisMSendComplete在調(diào)用中傳遞指向一個(gè)已被發(fā)送的包的描述符的指針。這個(gè)信息會(huì)傳給協(xié)議驅(qū)動(dòng)程序，指示完成了操作。

許多需要一定時(shí)間來(lái)完成的驅(qū)動(dòng)程序操作用完成數(shù)來(lái)完成支持異步的操作。這種函數(shù)有同一形式的名字NidisMXxxComplete。不僅可用于發(fā)送和接收函數(shù)，完成函數(shù)也可用于查詢、配置、重新設(shè)置硬件、狀態(tài)指示、指示收到數(shù)據(jù)和傳送收到數(shù)據(jù)。