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

[アーティクル]
02/26/2024

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