NDK_FN_CREATE_SHARED_ENDPOINTコールバック関数 (ndkpi.h)
NdkCreateSharedEndpoint (NDK_FN_CREATE_SHARED_ENDPOINT) 関数は、NDK 共有エンドポイントを作成します。
構文
NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;
NTSTATUS NdkFnCreateSharedEndpoint(
[in] NDK_ADAPTER *pNdkAdapter,
const PSOCKADDR pAddress,
[in] ULONG AddressLength,
[in] NDK_FN_CREATE_COMPLETION CreateCompletion,
[in, optional] PVOID RequestContext,
NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}
パラメーター
[in] pNdkAdapter
NDK アダプター オブジェクト (NDK_ADAPTER) へのポインター。
pAddress
発信接続の開始に使用するローカル アドレス。 AF_INETまたは AF_INET6 pAddress には、ローカル IP アドレスとローカル ND ポートが含まれます。
[in] AddressLength
pAddress パラメーターのローカル アドレス データのサイズ (バイト単位)。
[in] CreateCompletion
NDK オブジェクトの作成を完了する NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数へのポインター。
[in, optional] RequestContext
CreateCompletion パラメーターで指定された NdkCreateCompletion 関数に NDK プロバイダーが戻すコンテキスト値。
ppNdkSharedEndpoint
作成された共有エンドポイント オブジェクト (NDK_SHARED_ENDPOINT) へのポインターは、STATUS_PENDINGを返さずに要求が成功した場合に、この場所に返されます。 要求がSTATUS_PENDING返された場合、このパラメーターは無視され、作成されたオブジェクトは、CreateCompletion パラメーターで指定されたコールバックと共に返されます。
戻り値
NdkCreateSharedEndpoint 関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
|
共有エンドポイント オブジェクトが正常に作成され、*ppNdkSharedEndpoint パラメーターで返されました。 |
|
操作は保留中であり、後で完了します。 プロバイダーは、CreateCompletion パラメーター (NDK_FN_CREATE_COMPLETION) で指定された関数を呼び出して、保留中の操作を完了します。 |
|
リソースが不足しているため、要求が失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
|
|
指定されたローカル アドレスが既に使用されているため、要求は失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
|
|
コンシューマーがローカル ポート番号 0 を指定し、ネットワーク ダイレクト プロバイダーが一時ポート領域 (ポート 49152 から 65535) からポートを割り当てられなかったため、要求は失敗しました。 |
|
指定されたローカル アドレスがアダプターの有効なアドレスではないため、要求は失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
|
|
エラーが発生しました。 |
備考
NdkCreateSharedEndpoint 関数は、異なるリモート アドレス宛ての複数の送信接続のローカル アドレスとして使用する NDK 共有エンドポイントを作成します。 これは、リスナー オブジェクトによって表される同じローカル アドレスに対して複数の受信接続を持つことに似ています。
関数がSTATUS_SUCCESSを返す場合、作成されたオブジェクトは、ppNdkSharedEndpoint パラメーターで返されます。 NdkCreateSharedEndpoint がSTATUS_PENDINGを返 場合、作成されたオブジェクトは、CreateCompletion パラメーターで指定された NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数によって返されます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | サポートされていません。NDIS 6.30 以降でサポートされています。 |
| サポートされる最小サーバー | Windows Server 2012 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndkpi.h (Ndkpi.h を含む) |
| IRQL | <=DISPATCH_LEVEL |