Fungsi NdisMGetDeviceProperty (ndis.h)

  • Artikel

Fungsi NdisMGetDeviceProperty mengambil objek perangkat yang diperlukan untuk mengatur komunikasi dengan pengemudi miniport melalui pengemudi bus.

Sintaks

void NdisMGetDeviceProperty(
  [in]            NDIS_HANDLE       MiniportAdapterHandle,
  [out, optional] PDEVICE_OBJECT    *PhysicalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *FunctionalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *NextDeviceObject,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResources,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResourcesTranslated
);

Parameter

[in] MiniportAdapterHandle

Handel NDIS yang mengidentifikasi adaptor miniport. Handel ini awalnya diteruskan ke Fungsi MiniportInitializeEx .

[out, optional] PhysicalDeviceObject

Penunjuk ke buffer yang dialokasikan penelepon. Buffer menerima pointer ke struktur DEVICE_OBJECT yang mewakili perangkat fisik untuk adaptor miniport. Penunjuk ini bersifat opsional.

[out, optional] FunctionalDeviceObject

Penunjuk ke buffer yang dialokasikan penelepon. Buffer menerima pointer ke struktur DEVICE_OBJECT . DEVICE_OBJECT mewakili objek perangkat fungsi yang dibuat NDIS untuk perangkat fisik. Penunjuk ini bersifat opsional.

[out, optional] NextDeviceObject

Penunjuk ke buffer yang dialokasikan penelepon. Buffer menerima penunjuk ke struktur DEVICE_OBJECT yang mewakili objek perangkat berikutnya. Objek perangkat berikutnya ini didahului dalam rantai oleh objek perangkat fungsi yang termasuk dalam driver miniport. NDIS membuat objek perangkat fungsi ini untuk perangkat fisik. Misalnya, objek perangkat berikutnya bisa menjadi objek yang terkait dengan driver bus atau HAL Pointer ini bersifat opsional.

[out, optional] AllocatedResources

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima penunjuk ke struktur CM_RESOURCE_LIST. CM_RESOURCE_LIST menjelaskan daftar sumber daya perangkat keras yang ditetapkan manajer PnP ke perangkat fisik. Daftar ini berisi sumber daya dalam bentuk mentah, yaitu, tidak diterjemahkan oleh HAL. Penunjuk ini bersifat opsional.

[out, optional] AllocatedResourcesTranslated

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima penunjuk ke struktur CM_RESOURCE_LIST. CM_RESOURCE_LIST menjelaskan daftar sumber daya perangkat keras yang ditetapkan manajer PnP ke perangkat fisik. Daftar ini berisi sumber daya dalam formulir yang diterjemahkan, yaitu, diterjemahkan oleh HAL. Penunjuk ini bersifat opsional.

Nilai kembali

Tidak ada

Keterangan

Driver Miniport harus mengambil informasi tertentu untuk mengatur komunikasi mereka. Driver miniport untuk instans miniport yang berkomunikasi melalui driver bus menggunakan NdisMGetDeviceProperty untuk mengambil informasi ini. Misalnya, instans driver miniport yang melekat pada bus Universal Serial Bus (USB) atau IEEE 1394 memerlukan driver miniport yang mengekspos antarmuka driver miniport NDIS standar di tepi atasnya, dan menggunakan antarmuka kelas untuk bus tertentu di tepi bawahnya. Untuk menggunakan antarmuka kelas USB atau 1394, driver miniport membuat dan mengirimkan Paket Permintaan I/O (IRP). Driver miniport menggunakan objek fisik dan perangkat berikutnya yang diambil NdisMGetDeviceProperty untuk mengirimkan RUN ke antarmuka kelas untuk bus tertentu. Untuk menemukan informasi selengkapnya tentang membuat dan mengirimkan IRP ke pengemudi bus, lihat Menangani RUNPS.

Penunjuk ke DEVICE_OBJECT untuk objek fisik, fungsi, dan perangkat berikutnya yang diambil NdisMGetDeviceProperty hanya menangani yang buram ke driver miniport.

Driver miniport dapat memanggil NdisMGetDeviceProperty untuk mengambil pointer ke sumber daya "mentah" atau "diterjemahkan". Sumber daya mentah belum diterjemahkan oleh HAL; sumber daya yang diterjemahkan telah. Untuk menemukan informasi selengkapnya tentang sumber daya mentah dan terjemahan, lihat Plug and Play.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 5.1, dan NDIS 6.0 dan yang lebih baru. Untuk driver NDIS 5.1, lihat NdisMGetDeviceProperty (NDIS 5.1).
Target Platform Universal
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI Irql_Miniport_Driver_Function(ndis)

Lihat juga

DEVICE_OBJECT

MiniportInitializeEx