IoGetDiskDeviceObject-Funktion (ntifs.h)
Die IoGetDiskDeviceObject-Routine ruft einen Zeiger auf das Datenträgergeräteobjekt ab, das einem bestimmten Geräteobjekt des Dateisystemvolumes zugeordnet ist.
Syntax
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
Parameter
[in] FileSystemDeviceObject
Ein Zeiger auf das Dateisystemgeräteobjekt.
DiskDeviceObject
Ein Zeiger auf eine Variable, die die Adresse des Geräteobjekts für das Datenträgergeräteobjekt empfängt.
Rückgabewert
IoGetDiskDeviceObject gibt einen der folgenden status-Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Einer der Parameter, die an diese Funktion übergeben wurden, war ungültig. |
|
|
|
Hinweise
IoGetDiskDeviceObject gibt einen Zeiger auf das Speichergeräteobjekt zurück, das dem Dateisystemvolume zugeordnet ist. Das Speichergerät muss kein tatsächlicher Datenträger sein.
Dateisystemfiltertreiber rufen in der Regel IoGetDiskDeviceObject für ein Dateisystemvolumegeräteobjekt auf, um zu bestimmen, ob das Volume eingebunden ist.
IoGetDiskDeviceObject erhöht die Verweisanzahl auf dem Datenträgergeräteobjekt, auf das von DeviceObject verwiesen wird. Daher muss jeder erfolgreiche Aufruf von IoGetDiskDeviceObject durch einen nachfolgenden Aufruf von ObDereferenceObject abgeglichen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 SP4-Updaterollup; Windows XP |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |