次の方法で共有


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

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

VmbPacketInitialize 関数は、VMBus パケットを格納するバッファーを初期化します。

構文

FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;

NTSTATUS FnVmbPacketInitialize(
  VMBCHANNEL Channel,
  VMBPACKET VmbPacket,
  UINT32 ByteCount
)
{...}

パラメーター

Channel

チャネルのハンドル。

VmbPacket

VMBus パケットの格納に使用するバッファー。

ByteCount

バッファー のサイズ (バイト単位)。

戻り値

VmbPacketInitialize は、次の状態コードを返します。

リターン コード 形容
STATUS_SUCCESS
関数は正常に終了しました。
STATUS_INVALID_PARAMETER_3
ByteCount の値が無効です。 最大パケット サイズと void ポインターのサイズを超える必要があります。

備考

バッファーのサイズは、VmbChannelSizeofPacket 関数を使用して計算される少なくともサイズである必要があります。

VmbPacketInitialize は、VmbPacketAllocate 関数の代わりに使用できます。 呼び出し元がパケット オブジェクトのメモリを提供する場合は、現在の関数を使用します。

パケットの初期完了ルーチンは無効であり、パケットを送信する前に設定する必要があります。

大事な

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

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

必要条件

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

関連項目

VmbChannelSizeofPacket する

VmbPacketAllocate する