共用方式為

FN_VMB_CHANNEL_MAP_GPADL回呼函式 （vmbuskernelmodeclientlibapi.h）

[某些資訊與發行前的產品有關，在正式發行前可能會大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。

VmbChannelMapGpadl 函式會使用客體實體位址描述元清單 （GPADL） 號碼，將用戶端緩衝區對應至伺服器端實體地址空間。

語法

FN_VMB_CHANNEL_MAP_GPADL FnVmbChannelMapGpadl;

NTSTATUS FnVmbChannelMapGpadl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  UINT32 GpadlHandle,
  PMDL *Mdl
)
{...}

參數

Channel

通道的句柄。

Flags

標誌。 可能的旗標值為：

價值 意義
VMBUS_CHANNEL_GPADL_FLAG_READ_ONLY
 使用唯讀存取進行對應。
 

如果未設定此旗標值，函式會嘗試對應 GPADL 以進行寫入存取。 如果未建立具有寫入存取權的 GPADL，此對應嘗試就會失敗。 如果設定這個旗標，則呼叫端不會防止寫入緩衝區。 此配置可用來改善即時移轉和快照集的效能。

GpadlHandle

要對應之 GPADL 的 GPADL 句柄。

Mdl

描述客戶端緩衝區之 MDL 的指標。 此緩衝區只會對應到實體位址空間。 呼叫端必須採取其他步驟，將其對應至虛擬位址空間。

傳回值

如果作業成功，則傳回STATUS_SUCCESS，否則傳回適當的NTSTATUS錯誤碼。

言論

例如，客戶端必須使用 VmbChannelCreateGpadlFromBuffer 函式預先建立 GPADL。

一次只能有任何指定 GPADL 的單一對應。

您必須將此函式的呼叫與對 VmbChannelUnmapGpadl 函式的呼叫配對。

重要

此函式是透過 Vmbkmcl.sys 總線驅動程式提供的 VMBus 核心模式用戶端連結庫 （KMCL） 介面來呼叫。 這是從 KMCL_SERVER_ONLY_METHODS 結構存取的伺服器專用函式。

如需詳細資訊，請參閱 KMCL_SERVER_ONLY_METHODS的一節。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1803
標頭 vmbuskernelmodeclientlibapi.h

另請參閱

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl

  • Last updated on