IDirect3DDevice9 介面 (d3d9helper.h)

應用程式會使用 IDirect3DDevice9 介面的方法來執行 DrawPrimitive 型轉譯、建立資源、使用系統層級變數、調整 Gamma 坡形層級、使用調色盤，以及建立著色器。

繼承

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 方法 (d3d9helper.h) 會建立 Cube 紋理資源。
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) 會擷取交換鏈結的 gamma 修正坡形。
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) 設定隱含交換鏈結的 gamma 更正坡形。
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) 設定單一裝置轉譯狀態參數。
IDirect3DDevice9：：SetRenderTarget IDirect3DDevice9：：SetRenderTarget 方法 (d3d9helper.h) 設定裝置的新色彩緩衝區。
IDirect3DDevice9::SetSamplerState IDirect3DDevice9：：SetSamplerState 方法 (d3d9helper.h) 設定取樣器狀態值。
IDirect3DDevice9：：SetScissorRect IDirect3DDevice9：：SetScissorRect 方法 (d3d9helper.h) 會設定 scissor 矩形。
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) 設定 Vertex 宣告 (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：：TestCo (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