Funzione ChangerGetProductData (mcd.h)
ChangerGetProductData gestisce gli aspetti specifici del dispositivo di un IRP di controllo del dispositivo con il codice IOCTL IOCTL_CHANGER_GET_PRODUCT_DATA.
Sintassi
NTSTATUS ChangerGetProductData(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo che rappresenta il modificatore.
[in] Irp
Puntatore all'IRP.
Valore restituito
ChangerGetProductData restituisce sempre STATUS_SUCCESS.
Commenti
Questa routine è obbligatoria.
ChangerGetProductData restituisce i dati del prodotto per un modificatore.
Il driver di classe changer controlla la lunghezza del buffer di output nel percorso dello stack I/O prima di chiamare ChangerGetProductData. Se la lunghezza del buffer di output è inferiore a sizeof(CHANGER_PRODUCT_DATA), il driver di classe del modificatore restituisce con un valore di STATUS_INFO_LENGTH_MISMATCH
ChangerGetProductData compila una struttura CHANGER_PRODUCT_DATA in Irp-AssociatedIrp.SystemBuffer > prima di tornare al driver di classe del modificatore. Se i dati di richiesta del driver miniclasse sono stati memorizzati nella cache nell'estensione del dispositivo del modificatore prima di tornare da ChangerInitialize, tutti i membri tranne DeviceType possono essere compilati da questi dati.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | mcd.h (include Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |