Fungsi SpbTargetGetFileObject (spbcx.h)

  • Artikel

Metode SpbTargetGetFileObject menerima, sebagai parameter input, handel SPBTARGET ke perangkat target terbuka, dan mengembalikan handel WDFFILEOBJECT ke target ini.

Sintaks

WDFFILEOBJECT SpbTargetGetFileObject(
  [in] SPBTARGET Target
);

Parameter

[in] Target

Handel SPBTARGET ke perangkat target di bus.

Mengembalikan nilai

SpbTargetGetFileObject mengembalikan handel WDFFILEOBJECT ke perangkat target terbuka di bus. Metode mengembalikan NULL jika koneksi ke target ditutup oleh panggilan balik peristiwa EvtSpbTargetDisconnect .

Keterangan

Driver pengontrol Anda dapat memanggil metode ini untuk mendapatkan handel WDFFILEOBJECT ke perangkat target terbuka di bus. Driver pengontrol SPB kemudian dapat menggunakan handel ini sebagai parameter input ke metode WDF yang memerlukan handel seperti itu.

SpbTargetGetFileObject mengembalikan NULL hanya jika handel WDFFILEOBJECT ke target ditutup tetapi, sebelum ditutup, driver pengontrol SPB mengambil referensi tambahan pada objek SBPTARGET untuk memperpanjang masa pakainya.

Jika koneksi ditutup dan driver pengontrol SPB tidak memegang referensi ke objek SPBTARGET, handel SBPTARGET tidak lagi valid. Meneruskan handel yang tidak valid ke SpbTargetGetFileObject menyebabkan pemeriksaan bug.

Setelah SpbTargetGetFileObject mengembalikan handel WDFFILEOBJECT, tidak ada jaminan bahwa koneksi target akan tetap terbuka kecuali objek lain (misalnya, permintaan I/O aktif) memegang referensi ke objek WDFFILEOBJECT untuk mencegahnya menutup secara tiba-tiba. Metode ini paling berguna, dan, oleh karena itu, kemungkinan besar akan dipanggil, ketika koneksi target dijamin terbuka. Biasanya, panggilan tersebut terjadi selama panggilan balik EvtSpbTargetConnect dan EvtSpbTargetDisconnect , dan selama pemrosesan permintaan I/O.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Target Platform Universal
Header spbcx.h
Pustaka Spbcxstubs.lib
IRQL <= DISPATCH_LEVEL

Lihat juga

EvtSpbTargetConnect

EvtSpbTargetDisconnect

SPBTARGET