IClientVirtualDeviceSet2::MapBufferHandle (VDI)

  • 项目

适用于：SQL Server

MapBufferHandle 函数用于从通过其他某个进程获取的缓冲区句柄中获取有效的缓冲区地址。

语法

HRESULT IClientVirtualDeviceSet2::MapBufferHandle (
   DWORD      dwBuffer,
   BYTE**      ppBuffer
);

参数

dwBuffer 这是由 IClientVirtualDeviceSet2::GetBufferHandle 返回的句柄。

ppBuffer 这是当前进程中有效缓冲区的地址。

返回值

返回值 说明
NOERROR 函数成功。
VD_E_PROTOCOL 当前未打开虚拟设备集。
VD_E_INVALID ppBuffer 是无效的句柄。

备注

为了与句柄正确通信，必须格外谨慎。 对于单个虚拟设备集而言，句柄是本地的。 共享句柄的合作伙伴进程必须确保仅在最初获取缓冲区的虚拟设备集范围内使用缓冲区句柄。

后续步骤

有关详细信息，请参阅 SQL Server 虚拟设备接口引用概述。