PDD_CANCREATESURFACE fungsi panggilan balik (ddrawint.h)

Artikel
02/26/2024

Fungsi panggilan balik CanCreateD3DBuffer menentukan apakah driver dapat membuat perintah tingkat driver atau buffer vertex dari deskripsi yang ditentukan.

Sintaks

PDD_CANCREATESURFACE PddCancreatesurface;

DWORD PddCancreatesurface(
  PDD_CANCREATESURFACEDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Menunjuk ke struktur DD_CANCREATESURFACEDATA . Struktur ini berisi informasi yang diperlukan driver untuk menentukan apakah perintah atau buffer vertex dapat dibuat.

Nilai kembali

CanCreateD3DBuffer mengembalikan kode panggilan balik.

Keterangan

Panggilan balik ini hanya digunakan jika driver mengelola perintah tingkat driver dan buffer vertex.

CanCreateD3DBuffer harus memeriksa deskripsi permukaan bahwa anggota lpDDSurfaceDesc dari struktur DD_CANCREATESURFACEDATA di lpCanCreateD3DBuffer menunjuk untuk menentukan apakah driver dapat mendukung format dan kemampuan buffer yang diminta untuk mode tempat driver saat ini berada. Driver harus mengembalikan DD_OK di anggota ddRVal dari struktur yang sama jika mendukung jenis buffer tersebut. Jika tidak, itu harus mengembalikan kode kesalahan DDERR_Xxx yang paling menggambarkan mengapa tidak mendukung buffer.

Panggilan ini memiliki prototipe yang sama dengan DdCanCreateSurface. Callback CanCreateD3DBuffer digunakan, namun, ketika permukaan yang dimaksud memiliki bendera DDSCAPS_EXECUTEBUFFER yang diatur dalam anggota ddsCaps dari struktur DD_SURFACE_LOCAL .

Driver menentukan jenis buffer yang diminta dengan memeriksa anggota ddsCaps dari struktur DD_SURFACE_LOCAL untuk bendera berikut:

Bendera	Makna
DDSCAPS2_COMMANDBUFFER	Driver harus mengalokasikan buffer perintah.
DDSCAPS2_VERTEXBUFFER	Driver harus mengalokasikan buffer vertex eksplisit.

Catatan Jika tidak ada bendera yang diatur, driver harus mengalokasikan buffer vertex implisit. Buffer vertex implisit tidak boleh ditempatkan dalam memori video karena diharapkan dibaca/ditulis. Hanya buffer vertex eksplisit dengan set bendera DDSCAPS_WRITEONLY yang dapat ditempatkan dengan aman dalam memori video.