Share via

struktur DXGK_TIMED_OPERATION_INTERFACE (dispmprt.h)

  • Artikel

Struktur DXGK_TIMED_OPERATION_INTERFACE berisi pointer ke fungsi dalam Antarmuka Operasi Berwaktu, yang diimplementasikan oleh driver port tampilan.

Sintaks

typedef struct _DXGK_TIMED_OPERATION_INTERFACE {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  NTSTATUS((DXGK_TIMED_OPERATION *Op, const LARGE_INTEGER *Timeout,BOOLEAN OsHandled)              * )TimedOperationStart;
  NTSTATUS((DXGK_TIMED_OPERATION *Op,KPROCESSOR_MODE WaitMode,BOOLEAN Alertable, const LARGE_INTEGER *Interval)              * )TimedOperationDelay;
  NTSTATUS((DXGK_TIMED_OPERATION *Op,PVOID Object,KWAIT_REASON WaitReason,KPROCESSOR_MODE WaitMode,BOOLEAN Alertable, const LARGE_INTEGER *Timeout)              * )TimedOperationWaitForSingleObject;
} DXGK_TIMED_OPERATION_INTERFACE, *PDXGK_TIMED_OPERATION_INTERFACE;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Version

Nomor versi Antarmuka Operasi Berwakta. Konstanta nomor versi ditentukan dalam Dispmprt.h (misalnya, DXGK_TIMED_OPERATION_INTERFACE_VERSION_1).

Context

Penunjuk ke konteks yang disediakan oleh driver port tampilan.

InterfaceReference

Penunjuk ke fungsi referensi antarmuka yang diimplementasikan oleh driver port tampilan.

InterfaceDereference

Penunjuk ke fungsi dereferensi antarmuka yang diimplementasikan oleh driver port tampilan.

TimedOperationStart

Fungsi TimedOperationStart memulai atau memulai ulang operasi berwakmata.

Driver harus mengatur sebelumnya anggota Ukuran dari struktur DXGK_TIMED_OPERATION yang ditujukkan oleh parameter Op ke sizeof(DXGK_TIMED_OPERATION). Deskripsi parameter untuk TimedOperationStart mengikuti.

  • [keluar] Op adalah penunjuk ke struktur DXGK_TIMED_OPERATION yang menjelaskan operasi berwaktur untuk memulai atau memulai ulang.

  • [in] Batas waktu adalah penunjuk ke nilai waktu habis, dalam unit 100 nanodetik, yang menentukan waktu relatif yang dialokasikan agar operasi berwaktu selesai.

  • [in] OsHandled adalah nilai Boolean yang menentukan apakah sistem operasi menangani kondisi waktu habis. Nilai TRUE menunjukkan bahwa driver tidak memiliki cara yang wajar untuk menangani kondisi waktu habis dan memungkinkan sistem operasi menangani kondisi waktu habis; FALSE menunjukkan bahwa driver menangani kondisi waktu habis.

TimedOperationDelay

Fungsi TimedOperationDelay menempatkan utas saat ini ke dalam status tunggu yang dapat diperingatkan atau tidak dapat diubah untuk interval tertentu sehubungan dengan batas waktu operasi yang diberikan. Deskripsi parameter untuk TimedOperationDelay mengikuti.

  • [masuk/keluar] Op adalah penunjuk ke struktur DXGK_TIMED_OPERATION yang menjelaskan operasi berwaktur untuk menunda. Operasi berwaklu waktu ini dimulai dengan panggilan ke fungsi TimedOperationStart .

  • [in] WaitMode adalah nilai KPROCESSOR_MODE-typed yang menentukan mode prosesor yang ditunggu driver. Nilainya dapat berupa KernelMode atau UserMode. Driver tingkat bawah dalam tumpukan harus menentukan KernelMode.

  • [in] Dapat diperingatkan adalah nilai Boolean yang menentukan apakah penantian dapat diperingatkan. Nilai TRUE menunjukkan bahwa penantian dapat diperingatkan; FALSE menunjukkan bahwa penantian tidak dapat diubah. Driver tingkat bawah dalam tumpukan harus menentukan FALSE.

  • [in] Interval adalah penunjuk ke variabel yang berisi waktu relatif, dalam unit 100-nanodetik, untuk penundaan. Tanda nilai diabaikan.

TimedOperationWaitForSingleObject

Fungsi TimedOperationWaitForSingleObject menempatkan utas saat ini ke dalam status tunggu hingga objek dispatcher yang diberikan diatur ke status yang disinyalkan atau secara opsional sampai waktu tunggu habis atau sampai waktu habis dari operasi berwaktu yang diberikan kedaluwarsa. Deskripsi parameter untuk TimedOperationWaitForSingleObject mengikuti.

  • [in] Op adalah penunjuk ke struktur DXGK_TIMED_OPERATION yang menjelaskan operasi berwaktur untuk dimasukkan ke dalam status tunggu. Operasi berwaklu waktu ini dimulai dengan panggilan ke fungsi TimedOperationStart .

  • Objek adalah penunjuk ke objek dispatcher yang diinisialisasi yang disediakan pemanggil penyimpanan. Objek dispatcher dapat berupa peristiwa, mutex, semaphore, utas, atau timer.

  • WaitReason adalah nilai KWAIT_REASON-typed yang menentukan alasan untuk menunggu. Driver harus mengatur nilai ini ke Eksekutif atau, jika driver melakukan pekerjaan atas nama pengguna dan berjalan dalam konteks utas pengguna, ke UserRequest.

  • WaitMode adalah nilai KPROCESSOR_MODE-typed yang menentukan mode prosesor yang ditunggu driver. Nilainya dapat berupa KernelMode atau UserMode. Driver tingkat terendah dan menengah harus menentukan KernelMode. Jika objek yang diacu oleh parameter Objek adalah mutex, pemanggil harus menentukan KernelMode.

  • Dapat diperingatkan adalah nilai Boolean yang menentukan apakah penantian dapat diperingatkan. Nilai TRUE menunjukkan bahwa penantian dapat diperingatkan; FALSE menunjukkan bahwa penantian tidak dapat diubah.

  • Batas waktu adalah pointer ke variabel yang berisi waktu relatif, dalam unit 100-nanodetik, agar penantian selesai. Tanda nilai diabaikan.

Keterangan

Driver miniport tampilan memasok anggota Ukuran dan Versi dari struktur ini, dan kemudian memanggil DxgkCbQueryServices, yang mengisi anggota struktur ini yang tersisa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Header dispmprt.h (termasuk Dispmprt.h)

Lihat juga

DXGK_TIMED_OPERATION

DxgkCbQueryServices