struktur SDBUS_INTERFACE_STANDARD (ntddsd.h)

Artikel
02/26/2024

Struktur SDBUS_INTERFACE_STANDARD berisi penunjuk ke rutinitas metode antarmuka bus kartu Secure Digital (SD).

Sintaks

typedef struct _SDBUS_INTERFACE_STANDARD {
  USHORT                              Size;
  USHORT                              Version;
  PVOID                               Context;
  PINTERFACE_REFERENCE                InterfaceReference;
  PINTERFACE_DEREFERENCE              InterfaceDereference;
  PSDBUS_INITIALIZE_INTERFACE_ROUTINE InitializeInterface;
  PSDBUS_ACKNOWLEDGE_INT_ROUTINE      AcknowledgeInterrupt;
} SDBUS_INTERFACE_STANDARD, *PSDBUS_INTERFACE_STANDARD;

Anggota

Size

Menunjukkan ukuran, dalam byte, dari struktur ini. Pemanggil SdBusOpenInterface harus mengatur anggota ini ke sizeof(SDBUS_INTERFACE_STANDARD).

Version

Menunjukkan nomor versi antarmuka. Pemanggil SdBusOpenInterface harus mengatur anggota ini ke SDBUS_INTERFACE_VERSION.

Context

Arahkan ke informasi konteks yang disediakan driver bus setiap kali driver perangkat membuka antarmuka dengan SdBusOpenInterface. Informasi ini tersedia untuk pemanggil pada output setelah panggilan ke SdBusOpenInterface. Pemanggil harus meneruskan informasi ini sebagai parameter ke rutinitas antarmuka lain.

InterfaceReference

Penunjuk ke rutinitas jenis yang disediakan pengemudi bus PINTERFACE_REFERENCE yang menambah jumlah referensi antarmuka yang tersedia untuk pemanggil rutinitas SdBusOpenInterface ketika rutinitas ini kembali. SdBusOpenInterface secara otomatis menambah jumlah antarmuka menjadi satu, jadi dalam kebanyakan kasus, penelepon perlu menggunakan rutinitas ini.

Rutinitas ini mengikuti format standar rutinitas referensi antarmuka bus. Untuk deskripsi kasus umum, lihat ANTARMUKA.

InterfaceDereference

Pointer ke rutinitas jenis yang disediakan pengemudi bus PINTERFACE_DEREFERENCE yang mengurangi jumlah referensi antarmuka. Jika penelepon mengurangi jumlah referensi ke nol, pengemudi bus menutup antarmuka.

Rutinitas ini mengikuti format standar rutinitas dereferensi antarmuka bus. Untuk deskripsi kasus umum, lihat ANTARMUKA.

Driver perangkat harus menggunakan rutinitas ini untuk mendereferensikan antarmuka dalam kondisi berikut:

Driver perangkat menerima kueri menghapus IRP.
Driver perangkat menerima IRP penghapusan mendadak.
Driver perangkat menerima hapus IRP, tanpa terlebih dahulu menerima penghapusan kueri atau kejutan menghapus IRP.

Dalam semua kasus ini, driver perangkat harus mendereferensikan antarmuka sebelum meneruskan IRP ke pengemudi bus.

InitializeInterface

Pointer ke rutinitas jenis yang disediakan pengemudi bus PSDBUS_INITIALIZE_INTERFACE_ROUTINE yang mengatur parameter inisialisasi pada antarmuka.

AcknowledgeInterrupt

Penunjuk ke rutinitas jenis yang disediakan pengemudi bus PSDBUS_ACKNOWLEDGE_INT_ROUTINE yang digunakan driver perangkat SD untuk memberi tahu pengemudi bus bahwa ia telah selesai memproses gangguan.

Keterangan

Driver perangkat SD harus mendapatkan serangkaian rutinitas metode ini untuk berkomunikasi dengan pengemudi bus SD. Driver memanggil rutinitas pustaka SdBusOpenInterface untuk membuka antarmuka.