PINTERFACE_REFERENCE fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas InterfaceReference menaikkan jumlah referensi pada antarmuka yang ditentukan driver.

Sintaks

PINTERFACE_REFERENCE PinterfaceReference;

void PinterfaceReference(
  [in] PVOID Context
)
{...}

Parameter

[in] Context

Penunjuk ke informasi konteks khusus antarmuka. Pemanggil meneruskan nilai yang diteruskan sebagai anggota Konteks dari struktur INTERFACE untuk antarmuka.

Nilai kembali

Tidak ada

Keterangan

Perhatikan bahwa ini adalah kontrak per antarmuka, jadi tidak ada persyaratan IRQL umum seputar InterfaceReference/Dereference.

Anda dapat menggunakan rutinitas InterfaceDereference untuk mengurangi jumlah referensi untuk antarmuka.

Driver yang mengekspor antarmuka bertanggung jawab untuk memanggil InterfaceReference untuk menambah jumlah referensi sebelum driver mengekspor antarmuka. Misalnya, driver yang awalnya mengekspor antarmuka sebagai respons terhadap permintaan IRP_MN_QUERY_INTERFACE memanggil InterfaceReference. Selain itu, driver yang meneruskan pointer ke antarmuka ke driver lain harus memanggil InterfaceReference.

Perhatikan bahwa rutinitas InterfaceReference adalah kontrak per antarmuka, sehingga tidak ada persyaratan IRQL umum untuk memanggilnya.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

Lihat juga

ANTARMUKA

IRP_MN_QUERY_INTERFACE

InterfaceDereference