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 bus.
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 miniport. 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 DEVICE_OBJECT que representa el dispositivo físico para el adaptador de miniport. 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 de la cadena por el objeto de dispositivo funcional que pertenece al controlador de miniport. 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 en formato traducido, es decir, traducidos por HAL. Este puntero es opcional.
Valor devuelto
Ninguno
Observaciones
Los controladores de miniport deben recuperar información específica para configurar sus comunicaciones. Los controladores de miniporte 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 miniporte que se conectan al bus serie universal (USB) o a los buses IEEE 1394 requieren controladores de miniporte que exponen una interfaz de controlador de miniporte NDIS estándar en su borde superior y usan la interfaz de clase para el bus determinado en su borde inferior. Para usar la interfaz de clase USB o 1394, un controlador de miniporte crea y envía paquetes de solicitud de E/S (IRP). El controlador miniport 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 controladores de autobús, consulte Control de IRP.
Los punteros a DEVICE_OBJECT para los objetos de dispositivo físicos, funcionales y siguientes que NdisMGetDeviceProperty recuperaciones 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; se han traducido los recursos. Para buscar más información sobre los recursos sin procesar y traducidos, consulte Plug and Play.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 5.1 y NDIS 6.0 y versiones posteriores. Para ver los controladores NDIS 5.1, consulte NdisMGetDeviceProperty (NDIS 5.1). |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miniport_Driver_Function(ndis) |