Obtention d’informations WDM

[S’applique à KMDF uniquement]

L’infrastructure fournit plusieurs méthodes d’objet qui permettent à votre pilote d’obtenir des informations définies par WDM.

Obtention d’informations WDM sur le pilote et ses périphériques

Pour obtenir des informations WDM sur un pilote et ses périphériques, le pilote peut appeler les méthodes suivantes :

WdfFdoInitWdmGetPhysicalDevice
Récupère la structure DEVICE_OBJECT qui représente l’objet d’appareil physique (PDO). Un pilote peut appeler cette méthode avant que le pilote n’ait créé un objet de périphérique d’infrastructure pour l’appareil.

WdfDeviceWdmGetPhysicalDevice
Récupère la structure de DEVICE_OBJECT WDM qui représente l’AOP d’un appareil. Un pilote peut appeler cette méthode après avoir créé un objet d’appareil framework pour l’appareil.

WdfDeviceWdmGetDeviceObject
Retourne l’objet d’appareil WDM associé à un objet d’appareil d’infrastructure spécifié.

WdfDeviceWdmGetAttachedDevice
Retourne l’objet d’appareil WDM inférieur suivant dans la pile d’appareils.

WdfWdmDeviceGetWdfDeviceHandle
Retourne un handle à l’objet d’appareil framework associé à un objet d’appareil WDM spécifié.

WdfWdmDriverGetWdfDriverHandle
Retourne un handle à l’objet pilote d’infrastructure associé à un objet de pilote WDM spécifié.

Obtention d’informations WDM sur les demandes d’E/S

Pour obtenir des informations WDM sur les demandes d’E/S, un pilote peut appeler les méthodes suivantes :

WdfRequestWdmGetIrp
Retourne la structure IRP WDM associée à un objet de demande d’infrastructure spécifié. (En revanche, un pilote qui reçoit une IRP WDM en dehors de l’infrastructure peut créer un objet de demande de framework pour l’IRP en appelant WdfRequestCreateFromIrp.)

WdfRequestGetParameters
Récupère les paramètres associés à un objet de demande d’infrastructure spécifié. La plupart de ces paramètres proviennent de l’emplacement de la pile d’E/S WDM de la requête.)

WdfRequestRetrieveOutputWdmMdl
Récupère une liste de descripteurs mémoire (MDL) qui représente la mémoire tampon de sortie d’une requête d’E/S.

WdfRequestRetrieveInputWdmMdl
Récupère une MDL qui représente la mémoire tampon d’entrée d’une demande d’E/S.

WdfRequestFormatRequestUsingCurrentType
Copie le contenu de l’emplacement de la pile d’E/S du pilote appelant vers l’emplacement de pile d’E/S de la cible d’E/S locale du pilote.

WdfRequestWdmFormatUsingStackLocation
Définit le contenu de l’emplacement de la pile d’E/S pour la cible d’E/S locale du pilote.

Obtention d’informations WDM sur les cibles d’E/S

Pour obtenir des informations WDM sur les cibles d’E/S, un pilote peut appeler les méthodes suivantes :

WdfIoTargetWdmGetTargetDeviceObject
Retourne un pointeur vers l’objet d’appareil WDM associé à une cible d’E/S locale ou distante.

WdfIoTargetWdmGetTargetFileObject
Retourne un pointeur vers la structure FILE_OBJECT WDM associée à une cible d’E/S distante.

WdfIoTargetWdmGetTargetFileHandle
Retourne un handle au fichier associé à une cible d’E/S distante.

WdfIoTargetWdmGetTargetPhysicalDevice
Retourne un pointeur vers l’objet d’appareil physique WDM qui représente l’appareil d’une cible d’E/S distante.

Obtention d’informations WDM sur les interruptions et les DPC

Pour obtenir des informations WDM sur les interruptions et les appels de procédure différée (DPC), un pilote peut appeler les méthodes suivantes :

WdfInterruptWdmGetInterrupt
Retourne un pointeur vers la structure WDM KINTERRUPT associée à un objet d’interruption de framework spécifié.

WdfDpcWdmGetDpc
Retourne un pointeur vers la structure KDPC WDM associée à un objet DPC d’infrastructure spécifié.

Obtention d’informations WDM sur les cibles d’E/S USB

Pour obtenir des informations WDM sur les cibles d’E/S USB, un pilote peut appeler la méthode suivante :

WdfUsbTargetPipeWdmGetPipeHandle
Retourne le handle de type USBD_PIPE_HANDLE associé à un objet de canal d’infrastructure spécifié.

Obtention d’informations WDM sur le Registre

Pour obtenir des informations WDM sur le Registre, un pilote peut appeler la méthode suivante :

WdfRegistryWdmGetHandle
Retourne un handle WDM à la clé de Registre qu’un objet de clé de Registre d’infrastructure représente.

Obtention d’informations WDM sur les objets file

Pour obtenir des informations WDM sur les objets fichier, un pilote peut appeler la méthode suivante :

WdfFileObjectWdmGetFileObject
Retourne la structure FILE_OBJECT WDM associée à un objet de fichier d’infrastructure spécifié.