PINTERFACE_REFERENCE fungsi panggilan balik (wdm.h)
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) |