struktur D3DDDI_ESCAPEFLAGS (d3dukmdt.h)

Artikel
03/08/2023

Struktur D3DDDI_ESCAPEFLAGS mengidentifikasi bagaimana driver tampilan mode pengguna berbagi informasi dengan driver miniport tampilan.

Sintaks

typedef struct _D3DDDI_ESCAPEFLAGS {
  union {
    struct {
      UINT HardwareAccess : 1;
      UINT DeviceStatusQuery : 1;
      UINT ChangeFrameLatency : 1;
      UINT NoAdapterSynchronization : 1;
#if ...
      UINT Reserved : 1;
      UINT VirtualMachineData : 1;
      UINT DriverKnownEscape : 1;
      UINT DriverCommonEscape : 1;
#if ...
      UINT Reserved2 : 24;
#else
      UINT Reserved2 : 26;
#endif
#elif
      UINT Reserved : 28;
#elif
      UINT Reserved : 29;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  };
} D3DDDI_ESCAPEFLAGS;

Anggota

HardwareAccess

Nilai UINT yang menentukan apakah sistem operasi melakukan sinkronisasi tingkat kedua ke driver miniport tampilan untuk panggilan DxgkDdiEscape . Jika driver memerlukan tingkat sinkronisasi kedua dan bendera HardwareAccess tidak diatur, panggilan ke fungsi DxgkDdiEscape driver akan gagal.

Mulai dari Windows 8.1, jika anggota ini diatur, DeviceStatusQuery dan ChangeFrameLatency harus diatur ke nol.

Mengatur anggota ini setara dengan mengatur bit pertama dari anggota Nilai 32-bit (0x00000001).

DeviceStatusQuery

Jika diatur, ketika fungsi pfnEscapeCb dipanggil dan D3DDDICB_ESCAPE. Anggota PrivateDriverDataSize adalah sizeof(D3DDDI_EXECUTIONSTATEESCAPE), runtime Direct3D menginterpretasikan D3DDDICB_ESCAPE.Anggota pPrivateDriverData sebagai penunjuk ke buffer yang berisi struktur D3DDDI_EXECUTIONSTATEESCAPE . Selain itu, runtime memproses pfnEscapeCb sebagai kueri status dengan menulis info yang diminta ke buffer yang disediakan alih-alih mengirim panggilan DxgkDdiEscape ke driver miniport tampilan.

Jika anggota ini diatur, HardwareAccess dan ChangeFrameLatency harus diatur ke nol.

Didukung dimulai dengan Windows 8.1.

Sistem operasi mengabaikan anggota ini jika sebelum Windows 8.1, atau jika driver mode pengguna diinisialisasi dengan panggilan OpenAdapterXxx di mana anggota pOpenData-Interface> menunjukkan Direct3D versi 8 atau yang lebih lama.

Mengatur anggota ini setara dengan mengatur bit kedua dari anggota Nilai 32-bit (0x00000002).

ChangeFrameLatency

Jika diatur, ketika fungsi pfnEscapeCb dipanggil, D3DDDICB_ESCAPE. Anggota PrivateDriverDataSize adalah sizeof(D3DDDI_FRAMELATENCYESCAPE) dan kondisi dalam Keterangan juga terpenuhi, runtime Direct3D menginterpretasikan D3DDDICB_ESCAPE.Anggota pPrivateDriverData sebagai penunjuk ke buffer yang berisi struktur D3DDDI_FRAMELATENCYESCAPE . Selain itu, runtime memproses pfnEscapeCb sebagai permintaan untuk mengubah latensi bingkai maksimum subsistem kernel grafis DirectX dengan menulis info yang diminta ke buffer yang disediakan alih-alih mengirim panggilan DxgkDdiEscape ke driver miniport tampilan.

Jika anggota ini diatur, HardwareAccess dan DeviceStatusQuery harus diatur ke nol.

Didukung dimulai dengan Windows 8.1.

Mengatur anggota ini setara dengan mengatur bit ketiga dari anggota Nilai 32-bit (0x00000004).

NoAdapterSynchronization

Reserved

Anggota ini dicadangkan dan harus diatur ke nol. Mengatur anggota ini ke nol setara dengan mengatur 29 bit yang tersisa (0xFFFFFFF8) dari anggota Nilai 32-bit ke nol.

Anggota ini dicadangkan dan harus diatur ke nol. Mengatur anggota ini ke nol setara dengan mengatur 31 bit yang tersisa (0xFFFFFFFE) dari anggota Nilai 32-bit ke nol.

VirtualMachineData

Menunjukkan bahwa DxgkDdiEscape dipanggil dari komputer virtual.

DriverKnownEscape

Data pribadi driver menunjuk ke struktur terkenal.

DriverCommonEscape

Struktur yang ditentukan runtime titik data privat.

Reserved2

Anggota ini dicadangkan dan harus diatur ke nol.

Value

Anggota dalam serikat pekerja yang terkandung dalam D3DDDI_ESCAPEFLAGS yang dapat menyimpan satu nilai 32-bit yang mengidentifikasi cara berbagi informasi.

Keterangan

Jika ChangeFrameLatency diatur, panggilan pfnEscapeCb hanya akan berhasil jika:

Driver miniport tampilan bertanggung jawab atas konfigurasi adaptor tertaut (LDA) yang disediakan oleh satu vendor.
Aplikasi ini telah mengambil kepemilikan layar penuh eksklusif dari tampilan di beberapa titik dalam masa pakainya.
Aplikasi ini belum mengambil alih nilai latensi bingkai maksimum default 3.

Jika kondisi ini tidak terpenuhi, panggilan pfnEscapeCb mengembalikan kode kesalahan E_INVALIDARG .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	d3dukmdt.h (termasuk D3dumddi.h, D3dkmddi.h)

Lihat juga

D3DDDICB_ESCAPE

D3DDDI_EXECUTIONSTATEESCAPE

D3DDDI_FRAMELATENCYESCAPE

DXGKARG_ESCAPE

DxgkDdiEscape

pfnEscapeCb

Bagikan melalui