Funzione NdisMGetDeviceProperty (ndis.h)

  • Articolo

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)

Vedi anche

DEVICE_OBJECT

MiniportInitializeEx