IOCTL_PAR_QUERY_DEVICE_ID IOCTL (ntddpar.h)
Die IOCTL_PAR_QUERY_DEVICE_ID Anforderung gibt die IEEE 1284-Geräte-ID eines parallelen Geräts zurück, das vom systemseitig bereitgestellten Funktionstreiber für parallele Ports zugewiesen wurde.
Hauptcode
Eingabepuffer
Keine.
Eingabepufferlänge
Keine.
Ausgabepuffer
Das AssociatedIrp.SystemBuffer-Element verweist auf einen Puffer, den der Client zur Ausgabe der Geräte-ID ordnet. Der Puffer enthält die Geräte-ID und einen NULL-Abschlussator .
Länge des Ausgabepuffers
Der Parameter.DeviceIoControl.OutputBufferLength-Member gibt die Größe des Ausgabepuffers in Bytes an, der sowohl die Geräte-ID als auch einen NULL-Abschlussator enthalten kann. Ein Client kann eine IOCTL_PAR_QUERY_DEVICE_ID_SIZE Anforderung verwenden, um die erforderliche Puffergröße zu bestimmen. Eine Geräte-ID kann bis zu 64 KB groß sein.
Statusblock
Wenn die Anforderung erfolgreich ist, wird der Information-Member auf die Größe eines Puffers in Bytes festgelegt, der sowohl die Geräte-ID als auch einen NULL-Abschlussator enthält. Andernfalls wird das Element Information auf 0 festgelegt.
Der Statusmember ist auf einen der generischen status Werte festgelegt, die von Gerätesteuerungsanforderungen für parallele Geräte zurückgegeben werden, oder auf einen der folgenden Werte:
STATUS_BUFFER_TOO_SMALL
Der Ausgabepuffer, auf den AssociatedIrp.SystemBuffer verweist, ist kleiner als die Größe der Geräte-ID und eines NULL-Abschlussators in Bytes.
STATUS_IO_DEVICE_ERROR
Ein Geräte-E/A-Fehler ist aufgetreten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddpar.h (include Ntddpar.h) |