byte_count 属性

[byte_count] ACF 属性是一个参数属性，它将大小（以字节为单位）与指针指示的内存区域相关联。

[ function-attribute-list ] function-name(
    [byte_count(length-variable-name)] parameter-name);
    ...);

参数

function-attribute-list

指定零个或多个 ACF 函数属性。

function-name

指定 IDL 文件中定义的函数的名称。 函数名称是必需的。

length-variable-name

指定 [in]-only 参数的名称，该参数指定 由 parameter-name 引用的内存区域的大小（以字节为单位）。

parameter-name

指定 IDL 文件中定义的 [out]-only 指针参数的名称。

备注

ACF 属性 [byte_count] 表示 DCE IDL 的 Microsoft 扩展。 因此，使用 MIDL 编译器开关 /osf 时，此属性不可用。

注意

NDR64 语法中不再支持 [字节计数] 属性，因为难以估算所有 [out] 参数所需的大小。

 

指针参数引用的内存是连续的，不会由客户端存根分配或释放。 [byte_count] 属性的此功能使你可以在客户端内存中创建一个永久性缓冲区区域，该缓冲区可以在多次调用远程过程期间重复使用。

关闭客户端存根内存分配的功能使你可以优化应用程序以提高效率。 例如， [byte_count] 属性可由使用 Microsoft RPC 的服务提供商函数使用。 当用户应用程序调用服务提供程序 API 并发送指向缓冲区的指针时，服务提供商可以将缓冲区指针传递到远程函数。 服务提供商可以在多个远程调用期间重复使用缓冲区，而无需强制用户重新分配内存区域。

内存区域可以包含由多个指针组成的复杂数据结构。 由于内存区域是连续的，因此应用程序不必进行多次调用来单独释放每个指针和结构。 相反，它可以通过一次调用内存分配或释放例程来分配或释放内存区域。

缓冲区必须是 [out]-only 参数，而以字节为单位的缓冲区长度必须是 [in]-only 参数。

指定足以包含所有 [out] 参数的缓冲区。 由于隐藏的填充，请使用高估而不是精确计数。 例如，4 字节指针在 32 位平台上的 4 字节对齐边界上取消封送，8 字节指针位于 64 位平台上的 8 字节边界上。 因此，必须在缓冲区的空间中考虑存根将执行的对齐填充。 此外，C 语言编译期间使用的打包级别可能有所不同。 使用字节计数值，该值考虑为 C 语言编译期间使用的打包级别添加的其他打包字节。 涵盖 32 位平台和 64 位平台的安全做法是假定进入大内存块的每个对象从 8 倍的地址开始。

示例

/* IDL file */ 
HRESULT proc1([in] unsigned long length, 
              [out] struct my_struct * pMyStruct); 
 
/* ACF file */ 
proc1([byte_count(length)] pMyStruct);

另请参阅

应用程序配置文件 (ACF)

in

length_is

/osf

out

size_is