Función NdisMGetDeviceProperty (ndis.h)
La función NdisMGetDeviceProperty recupera los objetos de dispositivo necesarios para configurar la comunicación con un controlador de minipuerto a través de un controlador de autobús.
Sintaxis
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
);
Parámetros
[in] MiniportAdapterHandle
Identificador NDIS que identifica el adaptador de minipuerto. Este identificador se pasó originalmente al Función MiniportInitializeEx .
[out, optional] PhysicalDeviceObject
Puntero a un búfer asignado por el autor de la llamada. El búfer recibe un puntero a una estructura de DEVICE_OBJECT que representa el dispositivo físico para el adaptador de minipuerto. Este puntero es opcional.
[out, optional] FunctionalDeviceObject
Puntero a un búfer asignado por el autor de la llamada. El búfer recibe un puntero a una estructura de DEVICE_OBJECT . DEVICE_OBJECT representa el objeto de dispositivo funcional que crea NDIS para el dispositivo físico. Este puntero es opcional.
[out, optional] NextDeviceObject
Puntero a un búfer asignado por el autor de la llamada. El búfer recibe un puntero a una estructura DEVICE_OBJECT que representa el siguiente objeto de dispositivo. Este siguiente objeto de dispositivo va precedido en la cadena por el objeto de dispositivo funcional que pertenece al controlador de minipuerto. NDIS crea este objeto de dispositivo funcional para el dispositivo físico. Por ejemplo, el siguiente objeto de dispositivo podría ser el objeto asociado a un controlador de bus o HAL Este puntero es opcional.
[out, optional] AllocatedResources
Puntero a un búfer asignado por el autor de la llamada que recibe un puntero a una estructura de CM_RESOURCE_LIST. CM_RESOURCE_LIST describe una lista de recursos de hardware que el administrador de PnP asigna al dispositivo físico. Esta lista contiene los recursos en formato sin procesar, es decir, no traducidos por HAL. Este puntero es opcional.
[out, optional] AllocatedResourcesTranslated
Puntero a un búfer asignado por el autor de la llamada que recibe un puntero a una estructura de CM_RESOURCE_LIST. CM_RESOURCE_LIST describe una lista de recursos de hardware que el administrador de PnP asigna al dispositivo físico. Esta lista contiene los recursos traducidos, es decir, traducidos por HAL. Este puntero es opcional.
Valor devuelto
None
Observaciones
Los controladores de Miniport deben recuperar información específica para configurar sus comunicaciones. Los controladores de minipuerto para las instancias de miniporte que se comunican a través de los controladores de autobús usan NdisMGetDeviceProperty para recuperar esta información. Por ejemplo, las instancias de controlador de minipuerto que se conectan al bus serie universal (USB) o a los buses IEEE 1394 requieren controladores de minipuerto que exponen una interfaz de controlador de miniporte NDIS estándar en su borde superior y usan la interfaz de clase para el bus concreto en su borde inferior. Para usar la interfaz de clase USB o 1394, un controlador de minipuerto crea y envía paquetes de solicitud de E/S (IRP). El controlador de minipuerto usa los objetos físicos y de dispositivo siguiente que NdisMGetDeviceProperty recupera para enviar IRP a la interfaz de clase de un bus determinado. Para encontrar más información sobre cómo crear y enviar IRP a los controladores de autobús, consulte Control de IRP.
Los punteros a DEVICE_OBJECT para los objetos de dispositivo físicos, funcionales y siguientes que recupera NdisMGetDeviceProperty son simplemente controladores que son opacos para el controlador de miniport.
Los controladores de miniport pueden llamar a NdisMGetDeviceProperty para recuperar punteros a recursos "sin procesar" o "traducidos". HAL no ha traducido los recursos sin procesar; los recursos traducidos han sido. Para encontrar más información sobre los recursos sin procesar y traducidos, consulte Plug and Play.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con NDIS 5.1 y NDIS 6.0 y versiones posteriores. Para los controladores NDIS 5.1, consulte NdisMGetDeviceProperty (NDIS 5.1). |
| Plataforma de destino | Universal |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | Irql_Miniport_Driver_Function(ndis) |