ChangerGetProductData, fonction (mcd.h)
ChangerGetProductData gère les aspects spécifiques d’un IRP de contrôle d’appareil avec le code IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA.
Syntaxe
NTSTATUS ChangerGetProductData(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil qui représente le changeur.
[in] Irp
Pointeur vers l’IRP.
Valeur retournée
ChangerGetProductData retourne toujours STATUS_SUCCESS.
Remarques
Cette routine est obligatoire.
ChangerGetProductData retourne les données de produit d’un changeur.
Le pilote de classe de changeur vérifie la longueur de la mémoire tampon de sortie dans l’emplacement de la pile d’E/S avant d’appeler ChangerGetProductData. Si la longueur de la mémoire tampon de sortie est inférieure à sizeof(CHANGER_PRODUCT_DATA), le pilote de classe de change retourne avec une valeur de STATUS_INFO_LENGTH_MISMATCH
ChangerGetProductData remplit une structure CHANGER_PRODUCT_DATA dans Irp-AssociatedIrp.SystemBuffer> avant de revenir au pilote de classe de changeur. Si le pilote miniclasse a mis en cache les données d’interrogation dans l’extension d’appareil du changeur avant de retourner à partir de ChangerInitialize, tous les membres à l’exception de DeviceType peuvent être renseignés à partir de ces données.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | mcd.h (inclure Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |