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 的句柄輸入。
傳回值
下表顯示此函式的傳回值。
| 值 | Description |
|---|---|
| NDISIMGETDEVICECONTEXT | 傳回 MiniportAdapterHandle所識別虛擬NIC的裝置內容區域存取權。 |
| NULL | 如果驅動程式的 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 |