次の方法で共有

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA コールバック関数 (vmbuskernelmodeclientlibapi.h)

  • [アーティクル]

[一部の情報は、商用リリース前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoft は、ここで提供される情報に関して明示的または黙示的な保証を行いません。

VmbChannelInitSetMaximumExternalData 関数は、パケットによって記述されるが、パケット内で直接送信されないデータの最大サイズとチェーン長を設定します。 つまり、ExternalDataMdlによって記述されるバッファーの最大サイズです。

構文

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

パラメーター

Channel

カーネル モード クライアント ライブラリ (KMCL) チャネルへのポインター。

DataSize

外部データの最大サイズ。

ChainLength

受信 MDL チェーン内のメモリ記述子リスト (MDL) の最大数。

戻り値

VmbChannelInitSetMaximumExternalData は、次のいずれかの状態値を返すことができます。

リターン コード 形容
STATUS_SUCCESS
 関数は正常に終了しました。
STATUS_INVALID_PARAMETER_1
 チャネルの の値が無効であるか、無効な状態 (Disabled など) です。
STATUS_INVALID_PARAMETER_2
 DataSize 値が無効です。 ゼロ (0) が無効です。
STATUS_INVALID_PARAMETER_3
 ChainLength 値が無効です。 ゼロ (0) が無効です。

備考

KMCL により、リング バッファーは、指定された制限内のバッファーを含むパケットを送信するのに十分な大きさになります。

大事な

この関数は、Vmbkmcl.sys バス ドライバーによって提供される VMBus カーネル モード クライアント ライブラリ (KMCL) インターフェイスを介して呼び出されます。 これは、KMCL_CLIENT_INTERFACE_V1 構造体からアクセスされるクライアント関数です。

詳細については、KMCL_CLIENT_INTERFACE_V1の「解説」セクションを参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1803
ヘッダー vmbuskernelmodeclientlibapi.h