Fungsi NdisMGetDeviceProperty (ndis.h)
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) |