Fungsi D3DXCreateEffectFromFile

Artikel
06/13/2023

Buat efek dari ASCII atau deskripsi efek biner.

Sintaks

HRESULT D3DXCreateEffectFromFile(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        LPCTSTR           pSrcFile,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

Penunjuk ke perangkat yang akan membuat efeknya. Lihat IDirect3DDevice9.

pSrcFile [in]

Jenis: LPCTSTR

Arahkan ke nama file. Parameter ini mendukung string Unicode dan ANSI. Lihat Keterangan.

pDefines [in]

Jenis: const D3DXMACRO*

Array definisi makro praprosesor opsional yang dihentikan NULL. Lihat D3DXMACRO.

pInclude [in]

Jenis: LPD3DXINCLUDE

Penunjuk antarmuka opsional, ID3DXInclude, untuk digunakan untuk menangani arahan #include. Jika nilai ini NULL, #includes akan dihormati saat mengkompilasi dari file atau akan menyebabkan kesalahan saat dikompilasi dari sumber daya atau memori.

Bendera [in]

Jenis: DWORD

Jika pSrcFile berisi efek teks, bendera dapat berupa kombinasi Bendera D3DXSHADER dan bendera D3DXFX ; jika tidak, pSrcFile berisi efek biner dan satu-satunya bendera yang dihormati adalah bendera D3DXFX. Pengkompilasi Direct3D 10 HLSL sekarang menjadi default. Lihat Alat Pengkompilasi Efek untuk detailnya.

pPool [in]

Jenis: LPD3DXEFFECTPOOL

Penunjuk ke objek ID3DXEffectPool untuk digunakan untuk parameter bersama. Jika nilai ini NULL, tidak ada parameter yang akan dibagikan.

ppEffect [out]

Jenis: LPD3DXEFFECT*

Mengembalikan penunjuk ke buffer yang berisi efek yang dikompilasi. Lihat ID3DXEffect.

ppCompilationErrors [out]

Jenis: LPD3DXBUFFER*

Mengembalikan penunjuk ke buffer yang berisi daftar kesalahan kompilasi. Lihat ID3DXBuffer.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data LPCTSTR diselesaikan ke LPCSTR.

Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi menyelesaikan ke D3DXCreateEffectFromFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateEffectFromFileA karena string ANSI sedang digunakan.

Persyaratan

Persyaratan	Nilai
Header	D3DX9Effect.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Efek
D3DXCompileShader
D3DXCompileShaderFromResource

Bagikan melalui