IDirect3DDevice9 接口 (d3d9helper.h)

应用程序使用 IDirect3DDevice9 接口的方法执行基于 DrawPrimitive 的呈现、创建资源、使用系统级变量、调整伽玛渐变级别、使用调色板以及创建着色器。

继承

IDirect3DDevice9 接口继承自 IUnknown 接口。 IDirect3DDevice9 还具有以下类型的成员：

方法

IDirect3DDevice9 接口包含以下方法。

IDirect3DDevice9::BeginScene IDirect3DDevice9：：BeginScene 方法 (d3d9.h) 开始场景。
IDirect3DDevice9：：BeginStateBlock IDirect3DDevice9：：BeginStateBlock 方法 (d3d9.h) 向 Direct3D 发出信号以开始记录设备状态块。
IDirect3DDevice9：：Clear IDirect3DDevice9：：Clear 方法 (d3d9.h) 清除一个或多个图面，例如呈现目标、多个呈现目标、模具缓冲区或深度缓冲区。
IDirect3DDevice9：：ColorFill (d3d9.h) IDirect3DDevice9：：ColorFill 方法允许应用程序使用指定颜色填充D3DPOOL_DEFAULT图面的矩形区域。
IDirect3DDevice9：：CreateAdditionalSwapChain IDirect3DDevice9：：CreateAdditionalSwapChain 方法 (d3d9.h) 创建用于呈现多个视图的附加交换链。
IDirect3DDevice9：：CreateCubeTexture IDirect3DDevice9：：CreateCubeTexture 方法 (d3d9helper.h) 创建立方体纹理资源。
IDirect3DDevice9：：CreateDepthStencilSurface IDirect3DDevice9：：CreateDepthStencilSurface 方法 (d3d9helper.h) 创建深度模具资源。
IDirect3DDevice9：：CreateIndexBuffer IDirect3DDevice9：：CreateIndexBuffer 方法 (d3d9helper.h) 创建索引缓冲区。
IDirect3DDevice9：：CreateOffscreenPlainSurface IDirect3DDevice9：：CreateOffscreenPlainSurface 方法 (d3d9helper.h) 创建屏幕外图面。
IDirect3DDevice9：：CreatePixelShader IDirect3DDevice9：：CreatePixelShader 方法 (d3d9.h) 创建像素着色器。
IDirect3DDevice9：：CreateQuery IDirect3DDevice9：：CreateQuery 方法 (d3d9helper.h) 创建状态查询。
IDirect3DDevice9：：CreateRenderTarget IDirect3DDevice9：：CreateRenderTarget 方法 (d3d9helper.h) 创建呈现目标图面。
IDirect3DDevice9：：CreateStateBlock IDirect3DDevice9：：CreateStateBlock 方法 (d3d9helper.h) 创建一个新的状态块，其中包含所有设备状态、顶点相关状态或像素相关状态的值。
IDirect3DDevice9：：CreateTexture IDirect3DDevice9：：CreateTexture 方法 (d3d9helper.h) 创建纹理资源。
IDirect3DDevice9：：CreateVertexBuffer IDirect3DDevice9：：CreateVertexBuffer 方法 (d3d9helper.h) 创建顶点缓冲区。
IDirect3DDevice9：：CreateVertexDeclaration IDirect3DDevice9：：CreateVertexDeclaration 方法 (d3d9helper.h) 从设备和顶点元素创建顶点着色器声明。
IDirect3DDevice9：：CreateVertexShader IDirect3DDevice9：：CreateVertexShader 方法 (d3d9helper.h) 创建顶点着色器。
IDirect3DDevice9：：CreateVolumeTexture IDirect3DDevice9：：CreateVolumeTexture 方法 (d3d9helper.h) 创建卷纹理资源。
IDirect3DDevice9：:D eletePatch IDirect3DDevice9：:D eletePatch 方法 (d3d9helper.h) 释放缓存的高阶修补程序。
IDirect3DDevice9::DrawIndexedPrimitive IDirect3DDevice9：:D rawIndexedPrimitive 方法 (d3d9helper.h) 将指定的几何基元呈现为顶点数组。
IDirect3DDevice9::DrawIndexedPrimitiveUP IDirect3DDevice9：:D rawIndexedPrimitiveUP 方法 (d3d9helper.h) 使用用户内存指针指定的数据呈现指定的几何基元。
IDirect3DDevice9::DrawPrimitive IDirect3DDevice9：:D rawPrimitive 方法 (d3d9helper.h) 从当前数据输入流集中呈现指定类型的非索引几何基元序列。
IDirect3DDevice9::DrawPrimitiveUP IDirect3DDevice9：:D rawPrimitiveUP 方法 (d3d9helper.h) 将用户内存指针指定的数据呈现为指定类型的几何基元序列。
IDirect3DDevice9：:D rawRectPatch IDirect3DDevice9：:D rawRectPatch 方法 (d3d9helper.h) 使用当前设置的流绘制矩形补丁。
IDirect3DDevice9：:D rawTriPatch IDirect3DDevice9：:D rawTriPatch 方法 (d3d9.h) 使用当前设置的流绘制三角补丁。
IDirect3DDevice9::EndScene IDirect3DDevice9：：EndScene 方法 (d3d9.h) 结束通过调用 IDirect3DDevice9：：BeginScene 开始的场景。
IDirect3DDevice9：：EndStateBlock IDirect3DDevice9：：EndStateBlock 方法 (d3d9.h) 指示 Direct3D 停止记录设备状态块并检索指向状态块接口的指针。
IDirect3DDevice9：：EvictManagedResources IDirect3DDevice9：：EvictManagedResources 方法 (d3d9.h) 逐出所有托管资源，包括 Direct3D 和驱动程序管理的资源。
IDirect3DDevice9：：GetAvailableTextureMem IDirect3DDevice9：：GetAvailableTextureMem 方法 (d3d9.h) 返回可用纹理内存量的估计值。
IDirect3DDevice9：：GetBackBuffer IDirect3DDevice9：：GetBackBuffer 方法 (d3d9.h) 从设备的交换链中检索后台缓冲区。
IDirect3DDevice9：：GetClipPlane IDirect3DDevice9：：GetClipPlane 方法 (d3d9.h) 检索设备的用户定义剪裁平面的系数。
IDirect3DDevice9：：GetClipStatus IDirect3DDevice9：：GetClipStatus 方法 (d3d9.h) 检索剪辑状态。
IDirect3DDevice9：：GetCreationParameters IDirect3DDevice9：：GetCreationParameters 方法 (d3d9.h) 检索设备的创建参数。
IDirect3DDevice9：：GetCurrentTexturePalette IDirect3DDevice9：：GetCurrentTexturePalette 方法 (d3d9.h) 检索当前纹理调色板。
IDirect3DDevice9：：GetDepthStencilSurface IDirect3DDevice9：：GetDepthStencilSurface 方法 (d3d9.h) 获取 Direct3DDevice 对象拥有的深度模具图面。
IDirect3DDevice9：：GetDeviceCaps IDirect3DDevice9：：GetDeviceCaps 方法 (d3d9.h) 检索呈现设备的功能。
IDirect3DDevice9：：GetDirect3D IDirect3DDevice9：：GetDirect3D 方法 (d3d9.h) 返回创建设备的 Direct3D 对象的实例的接口。
IDirect3DDevice9：：GetDisplayMode IDirect3DDevice9：：GetDisplayMode 方法 (d3d9.h) 检索显示模式的空间分辨率、颜色分辨率和刷新频率。
IDirect3DDevice9：：GetFrontBufferData IDirect3DDevice9：：GetFrontBufferData 方法 (d3d9.h) 生成设备的前端缓冲区的副本，并将该副本放置在应用程序提供的系统内存缓冲区中。
IDirect3DDevice9：：GetFVF IDirect3DDevice9：：GetFVF 方法 (d3d9.h) 获取固定顶点函数声明。
IDirect3DDevice9：：GetGammaRamp IDirect3DDevice9：：GetGammaRamp 方法 (d3d9.h) 检索交换链的伽马校正渐变。
IDirect3DDevice9：：GetIndices IDirect3DDevice9：：GetIndices 方法 (d3d9.h) 检索索引数据。
IDirect3DDevice9：：GetLight IDirect3DDevice9：：GetLight 方法 (d3d9.h) 检索此设备使用的一组照明属性。
IDirect3DDevice9：：GetLightEnable IDirect3DDevice9：：GetLightEnable 方法 (d3d9.h) 检索设备中一组照明参数的启用或禁用活动状态。
IDirect3DDevice9：：GetMaterial IDirect3DDevice9：：GetMaterial 方法 (d3d9.h) 检索设备的当前材料属性。
IDirect3DDevice9：：GetNPatchMode IDirect3DDevice9：：GetNPatchMode 方法 (d3d9.h) 获取 N 补丁模式段。
IDirect3DDevice9：：GetNumberOfSwapChains IDirect3DDevice9：：GetNumberOfSwapChains 方法 (d3d9.h) 获取隐式交换链的数目。
IDirect3DDevice9：：GetPaletteEntries IDirect3DDevice9：：GetPaletteEntries 方法 (d3d9.h) 检索调色板条目。
IDirect3DDevice9：：GetPixelShader IDirect3DDevice9：：GetPixelShader 方法 (d3d9.h) 检索当前设置的像素着色器。
IDirect3DDevice9：：GetPixelShaderConstantB IDirect3DDevice9：：GetPixelShaderConstantB 方法 (d3d9.h) 获取布尔着色器常量。
IDirect3DDevice9：：GetPixelShaderConstantF IDirect3DDevice9：：GetPixelShaderConstantF 方法 (d3d9.h) 获取浮点着色器常量。
IDirect3DDevice9：：GetPixelShaderConstantI IDirect3DDevice9：：GetPixelShaderConstantI 方法 (d3d9.h) 获取整数着色器常量。
IDirect3DDevice9：：GetRasterStatus IDirect3DDevice9：：GetRasterStatus 方法 (d3d9.h) 返回描述显示交换链的监视器的光栅的信息。
IDirect3DDevice9：：GetRenderState IDirect3DDevice9：：GetRenderState 方法 (d3d9.h) 检索设备的呈现状态值。
IDirect3DDevice9：：GetRenderTarget IDirect3DDevice9：：GetRenderTarget 方法 (d3d9.h) 检索呈现器目标图面。
IDirect3DDevice9：：GetRenderTargetData IDirect3DDevice9：：GetRenderTargetData 方法 (d3d9.h) 将呈现器目标数据从设备内存复制到系统内存。
IDirect3DDevice9：：GetSamplerState IDirect3DDevice9：：GetSamplerState 方法 (d3d9.h) 获取采样器状态值。
IDirect3DDevice9：：GetScissorRect IDirect3DDevice9：：GetScissorRect 方法 (d3d9.h) 获取剪刀矩形。
IDirect3DDevice9：：GetSoftwareVertexProcessing IDirect3DDevice9：：GetSoftwareVertexProcessing 方法 (d3d9.h) 获取顶点硬件或软件处理模式。
IDirect3DDevice9：：GetStreamSource IDirect3DDevice9：：GetStreamSource 方法 (d3d9.h) 检索绑定到指定数据流的顶点缓冲区。
IDirect3DDevice9：：GetStreamSourceFreq IDirect3DDevice9：：GetStreamSourceFreq 方法 (d3d9.h) 获取流源分频器值。
IDirect3DDevice9：：GetSwapChain IDirect3DDevice9：：GetSwapChain 方法 (d3d9.h) 获取指向交换链的指针。
IDirect3DDevice9：：GetTexture IDirect3DDevice9：：GetTexture 方法 (d3d9.h) 检索分配给设备的阶段的纹理。
IDirect3DDevice9：：GetTextureStageState IDirect3DDevice9：：GetTextureStageState 方法 (d3d9.h) 检索已分配纹理的状态值。
IDirect3DDevice9：：GetTransform IDirect3DDevice9：：GetTransform 方法 (d3d9.h) 检索描述转换状态的矩阵。
IDirect3DDevice9：：GetVertexDeclaration IDirect3DDevice9：：GetVertexDeclaration 方法 (d3d9.h) 获取顶点着色器声明。
IDirect3DDevice9：：GetVertexShader IDirect3DDevice9：：GetVertexShader 方法 (d3d9.h) 检索当前设置的顶点着色器。
IDirect3DDevice9：：GetVertexShaderConstantB IDirect3DDevice9：：GetVertexShaderConstantB 方法 (d3d9.h) 获取布尔顶点着色器常量。
IDirect3DDevice9：：GetVertexShaderConstantF IDirect3DDevice9：：GetVertexShaderConstantF 方法 (d3d9.h) 获取浮点顶点着色器常量。
IDirect3DDevice9：：GetVertexShaderConstantI IDirect3DDevice9：：GetVertexShaderConstantI 方法 (d3d9.h) 获取整数顶点着色器常量。
IDirect3DDevice9：：GetViewport IDirect3DDevice9：：GetViewport 方法 (d3d9.h) 检索当前为设备设置的视区参数。
IDirect3DDevice9：：LightEnable IDirect3DDevice9：：LightEnable 方法 (d3d9.h) 启用或禁用设备中的一组照明参数。
IDirect3DDevice9：：MultiplyTransform IDirect3DDevice9：：MultiplyTransform 方法 (d3d9.h) 将设备的世界、视图或投影矩阵乘以指定的矩阵。
IDirect3DDevice9::Present IDirect3DDevice9：:P resent 方法 (d3d9.h) 在设备拥有的后台缓冲区序列中显示下一个缓冲区的内容。
IDirect3DDevice9：:P rocessVertices IDirect3DDevice9：:P rocessVertices 方法 (d3d9.h) 将顶点着色器定义的顶点处理应用于输入数据流集。
IDirect3DDevice9::Reset IDirect3DDevice9：：Reset 方法 (d3d9.h) 重置交换链的类型、大小和格式。
IDirect3DDevice9：：SetClipPlane IDirect3DDevice9：：SetClipPlane 方法 (d3d9.h) 设置设备的用户定义剪裁平面的系数。
IDirect3DDevice9：：SetClipStatus IDirect3DDevice9：：SetClipStatus 方法 (d3d9.h) 设置剪辑状态。
IDirect3DDevice9：：SetCurrentTexturePalette IDirect3DDevice9：：SetCurrentTexturePalette 方法 (d3d9.h) 设置当前纹理调色板。
IDirect3DDevice9::SetCursorPosition IDirect3DDevice9：：SetCursorPosition 方法 (d3d9.h) 设置光标位置和更新选项。
IDirect3DDevice9::SetCursorProperties IDirect3DDevice9：：SetCursorProperties 方法 (d3d9.h) 设置游标的属性。
IDirect3DDevice9：：SetDepthStencilSurface IDirect3DDevice9：：SetDepthStencilSurface 方法 (d3d9.h) 设置深度模具图面。
IDirect3DDevice9：：SetDialogBoxMode IDirect3DDevice9：：SetDialogBoxMode 方法 (d3d9.h) 允许在全屏模式应用程序中使用 GDI 对话框。
IDirect3DDevice9：：SetFVF IDirect3DDevice9：：SetFVF 方法 (d3d9.h) 设置当前顶点流声明。
IDirect3DDevice9：：SetGammaRamp IDirect3DDevice9：：SetGammaRamp 方法 (d3d9helper.h) 为隐式交换链设置伽马校正渐变。
IDirect3DDevice9：：SetIndices IDirect3DDevice9：：SetIndices 方法 (d3d9helper.h) 设置索引数据。
IDirect3DDevice9：：SetLight IDirect3DDevice9：：SetLight 方法 (d3d9helper.h) 为此设备分配一组照明属性。
IDirect3DDevice9：：SetMaterial IDirect3DDevice9：：SetMaterial 方法 (d3d9helper.h) 设置设备的材料属性。
IDirect3DDevice9：：SetNPatchMode IDirect3DDevice9：：SetNPatchMode 方法 (d3d9helper.h) 启用或禁用 N 补丁。
IDirect3DDevice9：：SetPaletteEntries IDirect3DDevice9：：SetPaletteEntries 方法 (d3d9helper.h) 设置调色板条目。
IDirect3DDevice9：：SetPixelShader IDirect3DDevice9：：SetPixelShader 方法 (d3d9helper.h) 将当前像素着色器设置为以前创建的像素着色器。
IDirect3DDevice9：：SetPixelShaderConstantB IDirect3DDevice9：：SetPixelShaderConstantB 方法 (d3d9helper.h) 设置布尔着色器常量。
IDirect3DDevice9：：SetPixelShaderConstantF IDirect3DDevice9：：SetPixelShaderConstantF 方法 (d3d9helper.h) 设置浮点着色器常量。
IDirect3DDevice9：：SetPixelShaderConstantI IDirect3DDevice9：：SetPixelShaderConstantI 方法 (d3d9helper.h) 设置整数着色器常量。
IDirect3DDevice9::SetRenderState IDirect3DDevice9：：SetRenderState 方法 (d3d9helper.h) 设置单个设备 render-state 参数。
IDirect3DDevice9：：SetRenderTarget IDirect3DDevice9：：SetRenderTarget 方法 (d3d9helper.h) 为设备设置新的颜色缓冲区。
IDirect3DDevice9::SetSamplerState IDirect3DDevice9：：SetSamplerState 方法 (d3d9helper.h) 设置采样器状态值。
IDirect3DDevice9：：SetScissorRect IDirect3DDevice9：：SetScissorRect 方法 (d3d9helper.h) 设置剪刀矩形。
IDirect3DDevice9：：SetSoftwareVertexProcessing IDirect3DDevice9：：SetSoftwareVertexProcessing 方法 (d3d9helper.h) 在软件和硬件顶点处理之间切换。
IDirect3DDevice9：：SetStreamSource IDirect3DDevice9：：SetStreamSource 方法 (d3d9helper.h) 将顶点缓冲区绑定到设备数据流。
IDirect3DDevice9：：SetStreamSourceFreq IDirect3DDevice9：：SetStreamSourceFreq 方法 (d3d9helper.h) 设置流源分频器值。
IDirect3DDevice9：：SetTexture IDirect3DDevice9：：SetTexture 方法 (d3d9helper.h) 为设备的阶段分配纹理。
IDirect3DDevice9：：SetTextureStageState IDirect3DDevice9：：SetTextureStageState 方法 (d3d9helper.h) 设置当前分配的纹理的状态值。
IDirect3DDevice9：：SetTransform IDirect3DDevice9：：SetTransform 方法 (d3d9helper.h) 设置单个设备转换相关的状态。
IDirect3DDevice9：：SetVertexDeclaration IDirect3DDevice9：：SetVertexDeclaration 方法 (d3d9helper.h) (Direct3D 9) 设置顶点声明。
IDirect3DDevice9：：SetVertexShader IDirect3DDevice9：：SetVertexShader 方法 (d3d9helper.h) 设置顶点着色器。
IDirect3DDevice9：：SetVertexShaderConstantB IDirect3DDevice9：：SetVertexShaderConstantB 方法 (d3d9helper.h) 设置布尔顶点着色器常量。
IDirect3DDevice9：：SetVertexShaderConstantF IDirect3DDevice9：：SetVertexShaderConstantF 方法 (d3d9helper.h) 设置浮点顶点着色器常量。
IDirect3DDevice9：：SetVertexShaderConstantI IDirect3DDevice9：：SetVertexShaderConstantI 方法 (d3d9helper.h) 设置整数顶点着色器常量。
IDirect3DDevice9：：SetViewport IDirect3DDevice9：：SetViewport 方法 (d3d9helper.h) 设置设备的视区参数。
IDirect3DDevice9::ShowCursor IDirect3DDevice9：：ShowCursor 方法 (d3d9helper.h) 显示或隐藏光标。
IDirect3DDevice9：：StretchRect IDirect3DDevice9：：StretchRect 方法 (d3d9helper.h) 将源矩形的内容复制到目标矩形。
IDirect3DDevice9::TestCooperativeLevel IDirect3DDevice9：：TestCooperativeLevel 方法 (d3d9helper.h) 报告窗口或全屏应用程序的 Direct3D 设备的当前协作级别状态。
IDirect3DDevice9：：UpdateSurface IDirect3DDevice9：：UpdateSurface 方法 (d3d9helper.h) 将像素的矩形子集从一个图面复制到另一个图面。
IDirect3DDevice9：：UpdateTexture IDirect3DDevice9：：UpdateTexture 方法 (d3d9helper.h) 更新纹理的脏部分。
IDirect3DDevice9：：ValidateDevice IDirect3DDevice9：：ValidateDevice 方法 (d3d9helper.h) 报告设备在传递中呈现当前纹理混合操作和参数的能力。

注解

IDirect3DDevice9 接口是通过调用 IDirect3D9：：CreateDevice 方法获取的。

此接口与所有 COM 接口一样，继承 IUnknown 接口方法。

LPDIRECT3DDEVICE9和PDIRECT3DDEVICE9类型定义为 指向 IDirect3DDevice9 接口的指针。

typedef struct IDirect3DDevice9 *LPDIRECT3DDEVICE9, *PDIRECT3DDEVICE9;

要求

要求	值
目标平台	Windows
标头	d3d9helper.h (包括 D3D9.h)

另请参阅

Direct3D 接口

IDirect3D9：：CreateDevice