Struktur INTERFACE (wdm.h)

Struktur INTERFACE menjelaskan antarmuka yang diekspor oleh driver untuk digunakan oleh driver lain.

Sintaks

typedef struct _INTERFACE {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
} INTERFACE, *PINTERFACE;

Anggota

Size

Ukuran, dalam byte, dari struktur yang menentukan antarmuka driver, termasuk struktur ini dan anggota khusus antarmuka.

Version

Versi antarmuka yang ditentukan driver.

Context

Arahkan ke informasi konteks khusus antarmuka.

InterfaceReference

Penunjuk ke rutinitas InterfaceReference yang disediakan driver yang menaikkan jumlah referensi antarmuka.

InterfaceDereference

Penunjuk ke rutinitas InterfaceDereference yang disediakan driver yang mengurangi jumlah referensi antarmuka.

Keterangan

Struktur INTERFACE harus disertakan sebagai anggota pertama dari semua struktur yang menjelaskan antarmuka yang dikembalikan oleh driver sebagai respons terhadap permintaan IRP_MN_QUERY_INTERFACE .

Rutinitas InterfaceReference harus dipanggil oleh driver yang mengekspor antarmuka, setiap kali driver memasok antarmuka tersebut sebagai respons terhadap IRP_MN_QUERY_INTERFACE. Demikian juga, jika driver yang meminta antarmuka kemudian meneruskannya ke driver lain, driver yang melewati antarmuka harus memanggil InterfaceReference atas nama driver yang menerimanya.

Setiap driver yang mengimpor antarmuka (baik dengan mengirim IRP_MN_QUERY_INTERFACE atau dengan menerima antarmuka dari driver lain) harus memanggil rutinitas InterfaceDereference setelah selesai menggunakan antarmuka. Setelah memanggil rutinitas InterfaceDereference , driver tidak dapat menggunakan antarmuka lagi tanpa terlebih dahulu mempertahankannya.

Saat memperkenalkan versi baru antarmuka yang ada, buat GUID baru alih-alih merevisi bidang Ukuran atau Versi dari struktur ini. Untuk informasi selengkapnya, lihat Menggunakan Antarmuka Driver-Defined.

Persyaratan

Persyaratan	Nilai
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h, Miniport.h)

Lihat juga

IRP_MN_QUERY_INTERFACE

InterfaceDereference