次の方法で共有

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

  • [アーティクル]

NdkCreateMr (NDK_FN_CREATE_MR) 関数は、NDK メモリ領域 (MR) オブジェクトを作成します。

構文

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

パラメーター

[in] pNdkPd

NDK 保護ドメイン (PD) オブジェクト (NDK_PD) へのポインター。

[in] FastRegister

TRUE の場合、MR は高速レジスタ専用です。 それ以外の場合、MR は通常のレジスタ専用です。

[in] CreateCompletion

NDK オブジェクトの作成を完了する NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数へのポインター。

[in, optional] RequestContext

CreateCompletion パラメーターで指定された NdkCreateCompletion 関数に NDK プロバイダーが戻すコンテキスト値。

ppNdkMr

STATUS_PENDINGを返さずに要求が成功した場合は、作成された MR オブジェクト (NDK_MR) へのポインターがこの場所に返されます。 NdkCreateMr が STATUS_PENDINGを返す場合、このパラメーターは無視され、作成されたオブジェクトは、CreateCompletion パラメーターで指定されたコールバックと共に返されます。

戻り値

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

リターン コード 形容
STATUS_SUCCESS
 MR オブジェクトが正常に作成され、*ppNdkMr パラメーターで返されました。
STATUS_PENDING
 操作は保留中であり、後で完了します。 プロバイダーは、CreateCompletion パラメーター (NDK_FN_CREATE_COMPLETION) で指定された関数を呼び出して、保留中の操作を完了します。
STATUS_INSUFFICIENT_RESOURCES
 リソースが不足しているため、要求が失敗しました。
重要な 要求は、この状態コードを使用してインラインで、また非同期的に失敗する可能性があります。
 
その他の状態コードの
 エラーが発生しました。

備考

NdkCreateMr 関数は、メモリ登録と高速登録要求に使用できる NDK メモリ領域 (MR) オブジェクトを作成します。 関数が STATUS_SUCCESSを返す場合、作成されたオブジェクトは ppNdkMr パラメーターで返されます。 NdkCreateMr STATUS_PENDINGを返す場合、作成されたオブジェクトは、CreateCompletion パラメーターで指定された NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数によって返されます。

必要条件

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

関連項目

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

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD