Функция NdisMGetDeviceProperty (ndis.h)
Функция NdisMGetDeviceProperty извлекает объекты устройств, необходимые для настройки связи с минипортом через водителя автобуса.
Синтаксис
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
);
Параметры
[in] MiniportAdapterHandle
Дескриптор NDIS, определяющий мини-адаптер. Этот дескриптор первоначально передан в функция MiniportInitializeEx.
[out, optional] PhysicalDeviceObject
Указатель на выделенный вызывающим буфером. Буфер получает указатель на структуру DEVICE_OBJECT, представляющую физическое устройство для минипорт-адаптера. Этот указатель является необязательным.
[out, optional] FunctionalDeviceObject
Указатель на выделенный вызывающим буфером. Буфер получает указатель на структуру DEVICE_OBJECT. DEVICE_OBJECT представляет функциональный объект устройства, который NDIS создает для физического устройства. Этот указатель является необязательным.
[out, optional] NextDeviceObject
Указатель на выделенный вызывающим буфером. Буфер получает указатель на структуру DEVICE_OBJECT, представляющую следующий объект устройства. Следующий объект устройства предшествует цепочке функциональным объектом устройства, принадлежащим драйверу минипорта. NDIS создает этот функциональный объект устройства для физического устройства. Например, следующий объект устройства может быть объектом, связанным с драйвером шины или HAL Этот указатель является необязательным.
[out, optional] AllocatedResources
Указатель на выделенный вызывающим буфером, который получает указатель на структуру CM_RESOURCE_LIST. CM_RESOURCE_LIST описывает список аппаратных ресурсов, назначенных диспетчеру PnP физическому устройству. Этот список содержит ресурсы в необработанной форме, т. е. не переведенные HAL. Этот указатель является необязательным.
[out, optional] AllocatedResourcesTranslated
Указатель на выделенный вызывающим буфером, который получает указатель на структуру CM_RESOURCE_LIST. CM_RESOURCE_LIST описывает список аппаратных ресурсов, назначенных диспетчеру PnP физическому устройству. Этот список содержит ресурсы в преобразованной форме, т. е. переведенные hal. Этот указатель является необязательным.
Возвращаемое значение
Никакой
Замечания
Минипорт водители должны получить определенную информацию, чтобы настроить связь. Мини-порты для экземпляров минипорта, взаимодействующих через водители автобуса, используют NdisMGetDeviceProperty для получения этих сведений. Например, для экземпляров драйвера мини-порта, которые присоединяются к автобусам универсальной последовательной шины (USB) или IEEE 1394, требуются мини-порты, которые предоставляют стандартный интерфейс драйвера мини-порта NDIS на верхнем краю и используйте интерфейс класса для конкретной шины на нижнем крае. Чтобы использовать интерфейс класса USB или 1394, драйвер минипорта создает и отправляет пакеты запросов ввода-вывода (IRPs). Минипорт-драйвер использует физические и объекты следующего устройства, которые NdisMGetDeviceProper ty извлекает для отправки irPs в интерфейс класса для определенной шины. Дополнительные сведения о создании и отправке IRP водителям шины см. в статье Обработка irPs.
Указатели на DEVICE_OBJECT для физических, функциональных и следующих объектов устройств, которые NdisMGetDeviceProper ty, являются просто дескрипторами, которые непрозрачны для минипорт-драйвера.
Драйверы минипорта могут вызывать NdisMGetDeviceProperty для получения указателей на необработанные или переведенные ресурсы. Необработанные ресурсы не были переведены HAL; переведенные ресурсы были. Дополнительные сведения о необработанных и переведенных ресурсах см. в разделе Plug and Play.