Fungsi WdfIoTargetCreate (wdfiotarget.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfIoTargetCreate membuat target I/O jarak jauh untuk perangkat tertentu.

Sintaks

NTSTATUS WdfIoTargetCreate(
  [in]           WDFDEVICE              Device,
  [in, optional] PWDF_OBJECT_ATTRIBUTES IoTargetAttributes,
  [out]          WDFIOTARGET            *IoTarget
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in, optional] IoTargetAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon yang menentukan atribut objek untuk objek target I/O. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[out] IoTarget

Penunjuk ke lokasi yang menerima handel ke objek target I/O.

Nilai kembali

WdfIoTargetCreate mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Parameter yang tidak valid terdeteksi.
STATUS_INSUFFICIENT_RESOURCES
 Memori tidak cukup untuk membuat objek target I/O baru.
STATUS_INVALID_DEVICE_REQUEST
 Anggota ParentObject dari struktur WDF_OBJECT_ATTRIBUTES yang ditentukan IoTargetAttributes tidak menentukan objek perangkat kerangka kerja yang ditentukan Perangkat , atau objek yang rantai induknya mengarah ke objek tersebut.
 

Untuk daftar nilai pengembalian lain yang dapat dikembalikan WdfIoTargetCreate, lihat Kesalahan Pembuatan Objek Kerangka Kerja.

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Setelah driver memanggil WdfIoTargetCreate, driver harus memanggil WdfIoTargetOpen sebelum dapat mengirim permintaan ke target I/O jarak jauh.

Jika driver menentukan objek induk di anggota ParentObject struktur WDF_OBJECT_ATTRIBUTES, objek induk dapat menjadi objek perangkat kerangka kerja atau objek apa pun yang rantai induknya mengarah ke objek perangkat kerangka kerja. Kerangka kerja akan menghapus objek target I/O saat (atau driver) menghapus objek perangkat.

Untuk informasi selengkapnya tentang WdfIoTargetCreate, lihat Menginisialisasi Target I/O Umum.

Jika driver Anda menyediakan fungsi panggilan balik EvtCleanupCallback atau EvtDestroyCallback untuk objek target I/O, perhatikan bahwa kerangka kerja memanggil fungsi panggilan balik ini di IRQL = PASSIVE_LEVEL.

Untuk informasi selengkapnya tentang target I/O, lihat Menggunakan Target I/O.

Contoh

Untuk contoh kode yang menggunakan WdfIoTargetCreate, lihat WdfIoTargetOpen.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfiotarget.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_OBJECT_ATTRIBUTES

WdfIoTargetBuka