次の方法で共有


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

NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数は、NDK オブジェクトの作成を完了します。

構文

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

パラメーター

[in, optional] Context

コンシューマーがオブジェクト作成関数を呼び出すときに NDK プロバイダーに渡されるコンテキスト値。 作成関数は、非同期の作成完了要求 NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数ポインターをコンテキストに提供します。

[in] Status

作成要求の非同期完了状態。 オブジェクトの種類ごとに返すことができる完了状態コードについては、オブジェクト作成関数 ( たとえば、NDK_FN_CREATE_CQ) を参照してください。

[in] pNdkObject

NDK オブジェクト ヘッダーへのポインター (NDK_OBJECT_HEADER)。

戻り値

なし

解説

メモ この関数は、NDK コンシューマーによって実装され、NDK プロバイダーに渡されます。
 
NDK オブジェクトは非同期関数を使用して作成されます。 これらの非同期オブジェクト作成関数は 、NDK_FN_CREATE_COMPLETION 関数ポインターを入力パラメーターとして受け取ります。

NDK プロバイダーは、非同期オブジェクト作成関数からSTATUS_PENDINGを返すことができます。 この場合、NDK プロバイダーは create completion 関数を呼び出して、オブジェクトの作成が完了したことを示す必要があります。

その他の状態コードは、インライン完了を示します。 この場合、プロバイダーは要求の作成完了関数を呼び出してはなりません。 create request 関数がSTATUS_PENDING以外のNT_STATUS状態コードを返す場合は、create request 関数を使用して出力パラメーターで作成されたオブジェクトを返す必要があります。

STATUS_PENDINGを返し、後で STATUS_SUCCESS を非同期的に完了する作成要求の場合、作成されたオブジェクトは pNdkObject パラメーターを使用して作成完了関数によって返される必要があり、プロバイダーは create request 関数のオブジェクト出力パラメーターにアクセスできません。

要件

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

こちらもご覧ください

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

NDK_FN_CREATE_CONNECTOR

NDK_FN_CREATE_CQ

NDK_FN_CREATE_LISTENER

NDK_FN_CREATE_MR

NDK_FN_CREATE_MW

NDK_FN_CREATE_PD

NDK_FN_CREATE_QP

NDK_FN_CREATE_QP_WITH_SRQ

NDK_FN_CREATE_SHARED_ENDPOINT

NDK_FN_CREATE_SRQ

NDK_OBJECT_HEADER