Funzione NdisMGetDeviceProperty (ndis.h)
La funzione NdisMGetDeviceProperty recupera gli oggetti dispositivo necessari per configurare la comunicazione con un driver miniport tramite un driver bus.
Sintassi
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
);
Parametri
[in] MiniportAdapterHandle
Handle NDIS che identifica l'adattatore miniport. Questo handle è stato originariamente passato al Funzione MiniportInitializeEx .
[out, optional] PhysicalDeviceObject
Puntatore a un buffer allocato dal chiamante. Il buffer riceve un puntatore a una struttura DEVICE_OBJECT che rappresenta il dispositivo fisico per l'adattatore miniport. Questo puntatore è facoltativo.
[out, optional] FunctionalDeviceObject
Puntatore a un buffer allocato dal chiamante. Il buffer riceve un puntatore a una struttura DEVICE_OBJECT . DEVICE_OBJECT rappresenta l'oggetto dispositivo funzionale creato da NDIS per il dispositivo fisico. Questo puntatore è facoltativo.
[out, optional] NextDeviceObject
Puntatore a un buffer allocato dal chiamante. Il buffer riceve un puntatore a una struttura DEVICE_OBJECT che rappresenta l'oggetto dispositivo successivo. L'oggetto dispositivo successivo è preceduto dalla catena dall'oggetto dispositivo funzionale appartenente al driver miniport. NDIS crea questo oggetto dispositivo funzionale per il dispositivo fisico. Ad esempio, l'oggetto dispositivo successivo potrebbe essere l'oggetto associato a un driver del bus o a HAL Questo puntatore è facoltativo.
[out, optional] AllocatedResources
Puntatore a un buffer allocato dal chiamante che riceve un puntatore a una struttura CM_RESOURCE_LIST. CM_RESOURCE_LIST descrive un elenco di risorse hardware assegnate dal manager PnP al dispositivo fisico. Questo elenco contiene le risorse in formato non elaborato, ovvero non tradotte da HAL. Questo puntatore è facoltativo.
[out, optional] AllocatedResourcesTranslated
Puntatore a un buffer allocato dal chiamante che riceve un puntatore a una struttura CM_RESOURCE_LIST. CM_RESOURCE_LIST descrive un elenco di risorse hardware assegnate dal manager PnP al dispositivo fisico. Questo elenco contiene le risorse in formato tradotto, ovvero tradotto da HAL. Questo puntatore è facoltativo.
Valore restituito
nessuno
Osservazioni
I driver Miniport devono recuperare informazioni specifiche per configurare le comunicazioni. I driver miniport per le istanze miniport che comunicano tramite i driver del bus usano NdisMGetDeviceProperty per recuperare queste informazioni. Ad esempio, le istanze del driver miniport che si collegano a bus USB (Universal Serial Bus) o IEEE 1394 richiedono driver miniport che espongono un'interfaccia del driver miniport NDIS standard al loro bordo superiore e usano l'interfaccia di classe per il bus specifico sul bordo inferiore. Per usare l'interfaccia della classe USB o 1394, un driver miniport crea e invia pacchetti di richiesta di I/O . Il driver miniport usa gli oggetti fisici e next-device recuperati da NdisMGetDeviceProperty per inviare i runtime di integrazione all'interfaccia della classe per un determinato bus. Per trovare altre informazioni sulla creazione e l'invio di irP ai driver del bus, vedere Gestione dei provider di integrazione.
I puntatori a DEVICE_OBJECT per gli oggetti dispositivo fisici, funzionali e successivi recuperati da NdisMGetDeviceProperty sono semplicemente handle opachi per il driver miniport.
I driver Miniport possono chiamare NdisMGetDeviceProperty per recuperare puntatori a risorse "non elaborate" o "tradotte". Le risorse non elaborate non sono state tradotte da HAL; le risorse tradotte sono state. Per individuare altre informazioni sulle risorse non elaborate e tradotte, vedere Plug and Play.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in NDIS 5.1 e NDIS 6.0 e versioni successive. Per i driver NDIS 5.1, vedere NdisMGetDeviceProperty (NDIS 5.1). |
Piattaforma di destinazione | Universale |
Intestazione | ndis.h (include Ndis.h) |
Libreria | Ndis.lib |
IRQL | PASSIVE_LEVEL |
Regole di conformità DDI | Irql_Miniport_Driver_Function(ndis) |