IDirect3DQuery9::GetData 方法 (d3d9helper.h)
轮询查询的资源以获取查询状态或查询结果。 有关查询的详细信息,请参阅查询 (Direct3D 9) 。
语法
HRESULT GetData(
[in, out] void *pData,
[in] DWORD dwSize,
[in] DWORD dwGetDataFlags
);
参数
[in, out] pData
类型: void*
指向包含查询数据的缓冲区的指针。 用户负责分配此项。 仅当 dwSize 为 0 时,pData 才能为 NULL。
[in] dwSize
类型: DWORD
pData 中的数据字节数。 如果将 dwSize 设置为零,则可以使用此方法轮询资源的查询状态。 请参阅备注。
[in] dwGetDataFlags
类型: DWORD
指定查询类型的数据标志。 有效值为 0 或 D3DGETDATA_FLUSH。 使用 0 可避免将批处理查询刷新到驱动程序,并使用D3DGETDATA_FLUSH继续刷新它们。 对于编写自己的等待版本的应用程序,在驱动程序收到刷新之前,不会实现查询结果。
返回值
类型: HRESULT
返回类型标识查询状态 (请参阅 查询 (Direct3D 9) ) 。 如果查询数据可用,该方法返回S_OK;如果查询数据可用,则返回S_FALSE。 这些值被视为成功的返回值。 如果在使用 D3DGETDATA_FLUSH 时方法失败,则可以D3DERR_DEVICELOST返回值。
注解
轮询查询状态时可能会丢失设备。 指定 D3DGETDATA_FLUSH 时,此方法将返回D3DERR_DEVICELOST以响应丢失的设备。 这使应用程序能够阻止由于丢失设备 (而无法响应查询) 而导致线程无休止地轮询。
应用程序不得编写仅调用 GetData ( ... 、0 ) 的代码,预计 GetData 最终会随着时间的推移返回S_OK。 即使应用程序过去曾对 GetData 使用 FLUSH 标志,也是如此。 例如:
// Enables an infinite loop:
while( pQuery->GetData( ... , 0 ) == S_FALSE ) ;
// Still enables an infinite loop:
pQuery->GetData( ... , D3DGETDATA_FLUSH );
while( pQuery->GetData( ... , 0 ) == S_FALSE ) ;
// Does not enable an infinite loop because eventually the command
// buffer will fill up and that will cause a flush to occur.
while( pQuery->GetData( ..., 0 ) == S_FALSE ) {
pDevice->SetTexture(...);
pDevice->Draw(...);
}
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d3d9helper.h (包括 D3D9.h) |
Library | D3D9.lib |