NdisMGetDeviceProperty, fonction (ndis.h)

  • Article

La fonction NdisMGetDeviceProperty récupère les objets d’appareil requis pour configurer la communication avec un pilote miniport via un pilote de bus.

Syntaxe

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
);

Paramètres

[in] MiniportAdapterHandle

Handle NDIS qui identifie l’adaptateur miniport. Ce handle a été initialement passé à Fonction MiniportInitializeEx .

[out, optional] PhysicalDeviceObject

Pointeur vers une mémoire tampon allouée par l’appelant. La mémoire tampon reçoit un pointeur vers une structure DEVICE_OBJECT qui représente l’appareil physique de l’adaptateur miniport. Ce pointeur est facultatif.

[out, optional] FunctionalDeviceObject

Pointeur vers une mémoire tampon allouée par l’appelant. La mémoire tampon reçoit un pointeur vers une structure DEVICE_OBJECT . DEVICE_OBJECT représente l’objet d’appareil fonctionnel créé par NDIS pour l’appareil physique. Ce pointeur est facultatif.

[out, optional] NextDeviceObject

Pointeur vers une mémoire tampon allouée par l’appelant. La mémoire tampon reçoit un pointeur vers une structure DEVICE_OBJECT qui représente l’objet d’appareil suivant. Cet objet d’appareil suivant est précédé dans la chaîne par l’objet de périphérique fonctionnel qui appartient au pilote miniport. NDIS crée cet objet d’appareil fonctionnel pour l’appareil physique. Par exemple, l’objet de périphérique suivant peut être l’objet associé à un pilote de bus ou HAL Ce pointeur est facultatif.

[out, optional] AllocatedResources

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit un pointeur vers une structure CM_RESOURCE_LIST. CM_RESOURCE_LIST décrit une liste des ressources matérielles que le gestionnaire PnP affecte à l’appareil physique. Cette liste contient les ressources sous forme brute, c’est-à-dire non traduites par HAL. Ce pointeur est facultatif.

[out, optional] AllocatedResourcesTranslated

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit un pointeur vers une structure CM_RESOURCE_LIST. CM_RESOURCE_LIST décrit une liste des ressources matérielles que le gestionnaire PnP affecte à l’appareil physique. Cette liste contient les ressources sous forme traduite, c’est-à-dire traduites par HAL. Ce pointeur est facultatif.

Valeur de retour

None

Remarques

Les pilotes miniport doivent récupérer des informations spécifiques pour configurer leurs communications. Les pilotes miniport pour les instances de miniport qui communiquent via des pilotes de bus utilisent NdisMGetDeviceProperty pour récupérer ces informations. Par exemple, les instances de pilotes miniport qui s’attachent aux bus USB (Universal Serial Bus) ou IEEE 1394 nécessitent des pilotes miniport qui exposent une interface de pilote de miniport NDIS standard sur leur bord supérieur et utilisent l’interface de classe pour le bus particulier sur leur bord inférieur. Pour utiliser l’interface de classe USB ou 1394, un pilote miniport crée et envoie des paquets de demandes d’E/S (IRP). Le pilote miniport utilise les objets physiques et de l’appareil suivant que NdisMGetDeviceProperty récupère pour envoyer des irps à l’interface de classe pour un bus particulier. Pour plus d’informations sur la création et l’envoi de runtimes d’intégration aux pilotes de bus, consultez Gestion des irps.

Les pointeurs vers DEVICE_OBJECT pour les objets d’appareil physiques, fonctionnels et suivants que NdisMGetDeviceProperty récupère sont simplement des poignées opaques pour le pilote miniport.

Les pilotes Miniport peuvent appeler NdisMGetDeviceProperty pour récupérer des pointeurs vers des ressources « brutes » ou « traduites ». Les ressources brutes n’ont pas été traduites par HAL ; les ressources traduites ont été. Pour plus d’informations sur les ressources brutes et traduites, consultez Plug-and-Play.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 5.1 et NDIS 6.0 et versions ultérieures. Pour les pilotes NDIS 5.1, consultez NdisMGetDeviceProperty (NDIS 5.1).
Plateforme cible Universal
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL PASSIVE_LEVEL
Règles de conformité DDI Irql_Miniport_Driver_Function(ndis)

Voir aussi

DEVICE_OBJECT

MiniportInitializeEx