IDirect3DDevice9 接口 (d3d9.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 IDirect3DDevice9：：ColorFill 方法 (d3d9.h) 允许应用程序使用指定颜色填充D3DPOOL_DEFAULT图面的矩形区域。 |
| IDirect3DDevice9：：CreateAdditionalSwapChain IDirect3DDevice9：：CreateAdditionalSwapChain 方法 (d3d9.h) 创建用于呈现多个视图的附加交换链。 |
| IDirect3DDevice9：：CreateCubeTexture IDirect3DDevice9：：CreateCubeTexture 方法 (d3d9.h) 创建多维数据集纹理资源。 |
| IDirect3DDevice9：：CreateDepthStencilSurface IDirect3DDevice9：：CreateDepthStencilSurface 方法 (d3d9.h) 创建深度模具资源。 |
| IDirect3DDevice9：：CreateIndexBuffer IDirect3DDevice9：：CreateIndexBuffer 方法 (d3d9.h) 创建索引缓冲区。 |
| IDirect3DDevice9：：CreateOffscreenPlainSurface IDirect3DDevice9：：CreateOffscreenPlainSurface 方法 (d3d9.h) 创建屏幕外图面。 |
| IDirect3DDevice9：：CreatePixelShader IDirect3DDevice9：：CreatePixelShader 方法 (d3d9.h) 创建像素着色器。 |
| IDirect3DDevice9：：CreateQuery IDirect3DDevice9：：CreateQuery 方法 (d3d9.h) 创建状态查询。 |
| IDirect3DDevice9：：CreateRenderTarget IDirect3DDevice9：：CreateRenderTarget 方法 (d3d9.h) 创建呈现目标图面。 |
| IDirect3DDevice9：：CreateStateBlock IDirect3DDevice9：：CreateStateBlock 方法 (d3d9.h) 创建一个新状态块，其中包含所有设备状态、顶点相关状态或像素相关状态的值。 |
| IDirect3DDevice9：：CreateTexture IDirect3DDevice9：：CreateTexture 方法 (d3d9.h) 创建纹理资源。 |
| IDirect3DDevice9：：CreateVertexBuffer IDirect3DDevice9：：CreateVertexBuffer 方法 (d3d9.h) 创建顶点缓冲区。 |
| IDirect3DDevice9：：CreateVertexDeclaration IDirect3DDevice9：：CreateVertexDeclaration 方法 (d3d9.h) 从设备和顶点元素创建顶点着色器声明。 |
| IDirect3DDevice9：：CreateVertexShader IDirect3DDevice9：：CreateVertexShader 方法 (d3d9.h) 创建顶点着色器。 |
| IDirect3DDevice9：：CreateVolumeTexture IDirect3DDevice9：：CreateVolumeTexture 方法 (d3d9.h) 创建卷纹理资源。 |
| IDirect3DDevice9：:D eletePatch IDirect3DDevice9：:D eletePatch 方法 (d3d9.h) 释放缓存的高阶修补程序。 |
| IDirect3DDevice9::DrawIndexedPrimitive IDirect3DDevice9：:D rawIndexedPrimitive 方法 (d3d9.h) 将指定的几何基元呈现为顶点数组。 |
| IDirect3DDevice9::DrawIndexedPrimitiveUP IDirect3DDevice9：:D rawIndexedPrimitiveUP 方法 (d3d9.h) 使用用户内存指针指定的数据呈现指定的几何基元。 |
| IDirect3DDevice9::DrawPrimitive IDirect3DDevice9：:D rawPrimitive 方法 (d3d9.h) 从当前一组数据输入流呈现指定类型的非索引几何基元序列。 |
| IDirect3DDevice9::DrawPrimitiveUP IDirect3DDevice9：:D rawPrimitiveUP 方法 (d3d9.h) 将用户内存指针指定的数据呈现为指定类型的几何基元序列。 |
| IDirect3DDevice9：:D rawRectPatch IDirect3DDevice9：:D rawRectPatch 方法 (d3d9.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 方法 (d3d9.h) 设置隐式交换链的伽马校正渐变。 |
| IDirect3DDevice9：：SetIndices IDirect3DDevice9：：SetIndices 方法 (d3d9.h) 设置索引数据。 |
| IDirect3DDevice9：：SetLight IDirect3DDevice9：：SetLight 方法 (d3d9.h) 为此设备分配一组照明属性。 |
| IDirect3DDevice9：：SetMaterial IDirect3DDevice9：：SetMaterial 方法 (d3d9.h) 设置设备的材料属性。 |
| IDirect3DDevice9：：SetNPatchMode IDirect3DDevice9：：SetNPatchMode 方法 (d3d9.h) 启用或禁用 N 补丁。 |
| IDirect3DDevice9：：SetPaletteEntries IDirect3DDevice9：：SetPaletteEntries 方法 (d3d9.h) 设置调色板条目。 |
| IDirect3DDevice9：：SetPixelShader IDirect3DDevice9：：SetPixelShader 方法 (d3d9.h) 将当前像素着色器设置为以前创建的像素着色器。 |
| IDirect3DDevice9：：SetPixelShaderConstantB IDirect3DDevice9：：SetPixelShaderConstantB 方法 (d3d9.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 方法 (d3d9.h) 报告窗口或全屏应用程序的 Direct3D 设备的当前协作级别状态。 |
| IDirect3DDevice9：：UpdateSurface IDirect3DDevice9：：UpdateSurface 方法 (d3d9.h) 将像素的矩形子集从一个图面复制到另一个图面。 |
| IDirect3DDevice9：：UpdateTexture IDirect3DDevice9：：UpdateTexture 方法 (d3d9.h) 更新纹理的脏部分。 |
| IDirect3DDevice9：：ValidateDevice IDirect3DDevice9：：ValidateDevice 方法 (d3d9.h) 报告设备在单个传递中呈现当前纹理混合操作和参数的能力。 |
备注
IDirect3DDevice9 接口是通过调用 IDirect3D9：：CreateDevice 方法获取的。
此接口与所有 COM 接口一样，继承 IUnknown 接口方法。
LPDIRECT3DDEVICE9 和 PDIRECT3DDEVICE9 类型定义为指向 IDirect3DDevice9 接口的指针。
typedef struct IDirect3DDevice9 *LPDIRECT3DDEVICE9, *PDIRECT3DDEVICE9;
要求
| 目标平台 | Windows |
| 标头 | d3d9.h (包括 D3D9.h) |