NdisMResetComplete 宏 (NDIS 6.x)
NdisMResetComplete 函式會傳回迷你埠驅動程式先前傳回NDIS_STATUS_PENDING之重設要求的最終狀態。
語法
void NdisMResetComplete(
NDIS_HANDLE MiniportAdapterHandle,
NDIS_STATUS Status,
BOOLEAN AddressingReset
);
參數
MiniportAdapterHandle
NDIS 原本傳遞至 MiniportInitializeEx 函式的迷你埠配接器句柄。
Status
剛完成重設作業的最終狀態。 傳回值與 MINIPORT_RESET回呼函式所列的值相同。
AddressingReset
布爾值,如果 NDIS 負責還原多播位址、封包篩選和工作卸除資訊的設定,則為 TRUE 。 在此情況下,迷你埠驅動程序負責還原 MiniportAdapterHandle 所參考之網路介面卡的其餘組態設定 (NIC) 。
如果 AddressingReset 為 FALSE,迷你埠驅動程式會負責還原 NIC 的所有組態設定。
如需詳細資訊,請參閱 硬體重設。
傳回值
無
備註
如果 MiniportResetEx 函式傳回NDIS_STATUS_PENDING,迷你埠驅動程式必須在完成重設作業時呼叫 NdisMResetComplete 。
通訊協定驅動程式無法在 NDIS 6.0 和更新版本中起始重設作業。
某些 NIC 會在發出軟重設時遺失所有多播位址、封包篩選或功能地址資訊。 這類 NIC 的驅動程式會在呼叫 NdisMResetComplete 時將 AddressingReset 設定為 TRUE,導致 NDIS 呼叫其 MiniportOidRequest 函式以還原尋址狀態。 如需詳細資訊,請參閱 硬體重設。
迷你埠驅動程序必須釋放它所持有的任何微調鎖定,才能呼叫 NdisMResetComplete。
在 NDIS 6.0 和更新版本中, NdisMResetComplete 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 否則, NdisMResetComplete 的呼叫端必須在 IRQL = DISPATCH_LEVEL執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本 |
標頭 | ndis.h |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_Miniport_Driver_Function () |