NdisIMGetBindingContext 函式 (ndis.h)
NdisIMGetBindingContext 函式可讓 NDIS 通訊協定驅動程式存取基礎中繼驅動程式所建立的裝置內容區域,以供較高層級通訊協定驅動程式所系結的虛擬迷你埠所建立。
語法
NDIS_HANDLE NdisIMGetBindingContext(
[in] NDIS_HANDLE NdisBindingHandle
);
參數
[in] NdisBindingHandle
NdisOpenAdapterEx 函式在 NdisBindingHandle 參數傳回的系結句柄,可識別呼叫端所系結之下一個較低中繼驅動程式的虛擬迷你埠。
傳回值
NdisIMGetBindingContext 會針對指定的虛擬迷你埠傳回裝置內容區域的句柄,如果不存在這類內容區域,則會傳回 NULL 。
備註
通訊協定驅動程式或中繼驅動程式可以從其 ProtocolBindAdapterEx 函式呼叫 NdisIMGetBindingContext,以存取其系結之虛擬迷你埠的裝置內容。 裝置內容會針對系結至相同基礎中繼驅動程式的所有過度通訊協定驅動程式,提供通用內容區域。
這類裝置內容區域是由較低層級的 NDIS 中繼驅動程式所配置並定義,並在呼叫 中傳遞至 NDIS NdisIMInitializeDeviceInstanceEx 函式。
所有呼叫 NdisIMGetBindingContext 的 通訊協定驅動程式都可以安全地假設基礎中繼驅動程式已從非分頁集區配置其內容區域。 它們應該將傳回的內容區域視為唯讀,並保留由定義它的基礎 NDIS 中繼驅動程式所設定的狀態。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisIMGetBindingContext (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisIMGetBindingContext (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | < DISPATCH_LEVEL |
DDI 合規性規則 | Irql_IM_Function (ndis) |