NdisMAllocatePort 関数 (ndis.h)
NdisMAllocatePort 関数は、ミニポート アダプターに関連付けられている NDIS ポートを割り当てます。
構文
NDIS_STATUS NdisMAllocatePort(
NDIS_HANDLE NdisMiniportHandle,
[in, out] PNDIS_PORT_CHARACTERISTICS PortCharacteristics
);
パラメーター
NdisMiniportHandle
NDIS が の MiniportAdapterHandle パラメーターに渡したミニポート アダプター ハンドル MiniportInitializeEx 関数。
[in, out] PortCharacteristics
へのポインター NDIS_PORT_CHARACTERISTICS ポートの特性を定義する構造体です。
戻り値
NdisMAllocatePort は、次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
|
NDIS がポートのリソースを正常に割り当てた。 |
|
NDIS は、ポートのリソースを割り当てませんでした。 |
|
関連付けられているミニポート アダプターが閉じているため、ポートの割り当てが失敗しました。 |
|
PortCharacteristics パラメーターで指定されたデータが無効です。 |
注釈
NdisMAllocatePort 関数は、ミニポート アダプターに関連付けられているポートのリソースとポート番号を割り当てます。 ミニポート ドライバーがポートの NetEventPortActivation プラグ アンド プレイ (PnP) イベントを発行するまで、ポートはアクティブではありません。
ミニポート ドライバーがポートをアクティブ化した後、NDIS は、上にあるドライバーの PnP 通知を生成します。 基になるドライバーまたはユーザー モード のアプリケーションがミニポート アダプターのポートを列挙する OID_GEN_ENUMERATE_PORTS OID を発行する場合、NDIS は、ポートの一覧に非アクティブな割り当てられたポートを含まれません。
NdisMAllocatePort が正常に返されると、 の PortNumber メンバーPortCharacteristics パラメーターが指定するNDIS_PORT_CHARACTERISTICS構造体は、NDIS がポートに割り当てたポート番号に設定されます。
ポートが不要になった後、ミニポート ドライバーは NdisMFreePort 関数を呼び出してポートを解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.0 以降でサポートされています。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |