NdisMCoIndicateStatusEx 函式 (ndis.h)
NdisMCoIndicateStatusEx 函式會報告 CoNDIS 迷你埠配接器的狀態變更。
語法
void NdisMCoIndicateStatusEx(
[in] NDIS_HANDLE MiniportAdapterHandle,
[in, optional] NDIS_HANDLE NdisVcHandle,
[in] PNDIS_STATUS_INDICATION StatusIndication
);
參數
[in] MiniportAdapterHandle
在 MiniportAdapterHandle 參數上傳遞的 NDIS 迷你埠配接器句柄 MiniportInitializeEx 函式。
[in, optional] NdisVcHandle
識別虛擬連線 (VC) 的句柄。 迷你埠驅動程式會取得此句柄做為其 MiniportCoCreateVc 函式的輸入參數,不論是在用戶端設定傳出呼叫或呼叫管理員為客戶端註冊的服務存取點建立 VC 時, (SAP) 。 呼叫管理員已建立 VC,以指出來電通知。 若要將狀態指示傳送至所有通訊協議係結,請將此參數設定為 NULL。
[in] StatusIndication
包含狀態資訊的 NDIS_STATUS_INDICATION 結構的指標。
傳回值
無
備註
當迷你埠驅動程式使用 NdisVcHandle 參數的 NULL VC 句柄呼叫 NdisMCoIndicateStatusEx 時,NDIS 會藉由呼叫每個系結通訊協定驅動程式的 ProtocolCoStatusEx 函式,將狀態變更通知轉送至所有系結通訊協定驅動程式。 使用非 NULL VC 句柄呼叫 NdisMCoIndicateStatusEx,會將狀態通知限制給迷你埠驅動程式與此 VC 句柄共用的用戶端或呼叫管理員。
迷你埠驅動程式可以在設定其註冊屬性之後呼叫 NdisMCoIndicateStatusEx ,方法是呼叫 NdisMSetMiniportAttributes 函式來自其 MiniportInitializeEx 函式,即使驅動程式仍在 MiniportInitializeEx 函式的內容中也一樣。 驅動程式在從 MiniportHaltEx 函式傳回之後,不得呼叫 NdisMCoIndicateStatusEx。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_MCO_Function (ndis) |