NdisIMGetDeviceContext 函式 （ndis.h）
附註 NDIS 5。 x 已被取代，且已被 NDIS 6 取代。 x。 如需新的 NDIS 驅動程式開發，請參閱從 Windows Vista 開始網路驅動程式。 如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x，請參閱 將 NDIS 5.x 驅動程式移植到 NDIS 6.0。
此函式可讓 NDIS 中繼驅動程式的 MiniportInitialize 函式存取其 ProtocolBindAdapter 函式所配置的裝置內容區域。
語法
NDIS_HANDLE NdisIMGetDeviceContext(
[in] NDIS_HANDLE MiniportAdapterHandle
);
參數
[in] MiniportAdapterHandle
指定 MiniportInitialize的句柄輸入。
傳回值
下表顯示此函式的傳回值。
| 價值 | 描述 |
|---|---|
| NDISIMGETDEVICECONTEXT | 傳回 MiniportAdapterHandle所識別之虛擬 NIC 的裝置內容區域存取權。 |
| 零 | 如果驅動程式的 ProtocolBindAdapter 函式未配置這類裝置內容區域。 |
言論
NDIS 中繼驅動程式的 MiniportInitialize 函式會呼叫 NdisIMGetDeviceContext，以存取正在初始化之虛擬 NIC 的裝置內容區域。 通常，中繼驅動程式的 ProtocolBindAdapter 函式會提供這類區域的記憶體，函式會呼叫 NdisIMInitializeDeviceInstanceEx，進而呼叫驅動程式的 MiniportInitialize 函式。 不過，中繼驅動程式不需要有這類內容區域。
從 NdisIMGetDeviceContext傳回時，MiniportInitialize 使用中繼驅動程式寫入器想要對後續系結至其虛擬 NIC 的較高層級通訊協定，設定驅動程式定義狀態。
後續系結至相同虛擬 NIC 的較高層級 NDIS 通訊協定，可以從其 ProtocolBindAdapter 函式呼叫 NdisIMGetBindingContext，以存取此裝置內容區域。
作系统版本： Windows CE .NET 4.0 和更新版本。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | ndis.h |
| 連結庫 | Ndis.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |