次の方法で共有

NDK_FN_LISTEN コールバック関数 (ndkpi.h)

  • [アーティクル]

NdkListen (NDK_FN_LISTEN) 関数は、NDK リスナー オブジェクトをリッスン モードにします。

構文

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

パラメーター

[in] pNdkListener

NDK リスナー オブジェクト (NDK_LISTENER) へのポインター。

pAddress

リッスンするローカル アドレス。 AF_INETまたは AF_INET6 pAddress には、ローカル IP アドレスとローカル ND ポートが含まれます。

[in] AddressLength

pAddress パラメーターのローカル アドレス データのサイズ (バイト単位)。

[in] RequestCompletion

NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) 要求完了コールバック ルーチンへのポインター。

[in, optional] RequestContext

RequestCompletion パラメーターで指定されたコールバック関数の Context パラメーターに渡すコンテキスト値。

戻り値

NdkListen 関数は、次の NTSTATUS コードのいずれかを返します。

リターン コード 形容
STATUS_SUCCESS
 リッスン要求が成功しました。
STATUS_PENDING
 操作は保留中であり、後で完了します。 ドライバーは、指定した RequestCompletion (NDK_FN_REQUEST_COMPLETION) 関数を呼び出して、保留中の操作を完了します。
STATUS_INSUFFICIENT_RESOURCES
 リソースが不足しているため、要求が失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
 
STATUS_SHARING_VIOLATION
 指定されたローカル アドレスが既に使用されているため、要求は失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
 
STATUS_INVALID_ADDRESS
 指定されたローカル アドレスがアダプターの有効なアドレスではないため、要求は失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
 
STATUS_TOO_MANY_ADDRESSES
 コンシューマーがローカル ポート番号 0 を指定し、ネットワーク ダイレクト プロバイダーが一時ポート領域 (ポート 49152 から 65535) からポートを割り当てられなかったため、要求は失敗しました。
その他の状態コードの
 エラーが発生しました。

備考

NdkListen 、リスナー オブジェクトを指定されたローカル アドレスでリッスン モードにします。

必要条件

要件 価値
サポートされる最小クライアント サポートされていません。NDIS 6.30 以降でサポートされています。
サポートされる最小サーバー Windows Server 2012
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndkpi.h (Ndkpi.h を含む)
IRQL <=DISPATCH_LEVEL

関連項目

NDKPI オブジェクトの有効期間の要件

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER