共用方式為

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 函式的呼叫配對。

重要

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

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

規格需求

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

另請參閱

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl