Fungsi ScsiPortWmiGetInstanceName (scsiwmi.h)
Rutinitas ScsiPortWmiGetInstanceName mengembalikan penunjuk ke nama instans yang terkait dengan Blok Permintaan SCSI (SRB) Instrumentasi Manajemen Windows (WMI) yang ditunjukkan.
Sintaks
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
Parameter
[in] RequestContext
Penunjuk ke struktur jenis SCSIWMI_REQUEST_CONTEXT yang berisi konteks permintaan untuk WMI SRB.
Nilai kembali
Penunjuk ke string yang dihitung yang berisi nama instans yang terkait dengan SRB yang ditunjukkan. Jika jenis SRB adalah jenis yang tidak menggunakan nama instans, ScsiPortWmiGetInstanceName mengembalikan NULL.
Keterangan
Parameter RequestContext menunjuk ke struktur konteks permintaan, SCSIWMI_REQUEST_CONTEXT, yang berisi informasi yang terkait dengan blok permintaan SCSI Windows Management Instrumentation (WMI). Struktur konteks permintaan, pada gilirannya, berisi salah satu Struktur WNODE_XXX WMI yang digunakan oleh sistem WMI untuk meneruskan data antara konsumen data mode pengguna dan penyedia data mode kernel seperti driver.
Struktur WNODE_XXX yang terkandung dalam konteks permintaan menyimpan nama instans yang terkait dengan WMI SRB. Driver miniport memanggil ScsiPortWmiGetInstanceName untuk mengekstrak nama instans ini dari konteks permintaan.
Memori yang dialokasikan untuk konteks permintaan harus tetap valid sampai setelah driver miniport memanggil ScsiPortWmiPostProcess, dan ScsiPortWmiPostProcess mengembalikan status SRB akhir dan ukuran buffer. Jika SRB dapat tertunda, memori untuk konteks permintaan harus dialokasikan dari ekstensi SRB. Jika SRB tidak dapat tertunda, memori dapat dialokasikan dari bingkai tumpukan yang tidak keluar dari cakupan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | scsiwmi.h (termasuk Miniport.h, Scsi.h) |