Função IoGetDiskDeviceObject (ntifs.h)
A rotina IoGetDiskDeviceObject recupera um ponteiro para o objeto de dispositivo de disco associado a um determinado objeto de dispositivo de volume do sistema de arquivos.
Sintaxe
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
Parâmetros
[in] FileSystemDeviceObject
Um ponteiro para o objeto do dispositivo do sistema de arquivos.
DiskDeviceObject
Um ponteiro para uma variável que recebe o endereço do objeto do dispositivo para o objeto do dispositivo de disco.
Retornar valor
IoGetDiskDeviceObject retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
Um dos parâmetros passados para essa função era inválido. |
|
|
|
Comentários
IoGetDiskDeviceObject retorna um ponteiro para o objeto de dispositivo de armazenamento associado ao volume do sistema de arquivos. O dispositivo de armazenamento não precisa ser um disco real
Os drivers de filtro do sistema de arquivos normalmente chamam IoGetDiskDeviceObject para um objeto de dispositivo de volume do sistema de arquivos para determinar se o volume está montado.
IoGetDiskDeviceObject incrementa a contagem de referência no objeto de dispositivo de disco apontado por DeviceObject. Portanto, cada chamada bem-sucedida para IoGetDiskDeviceObject deve ser correspondida por uma chamada subsequente para ObDereferenceObject.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Pacote cumulativo de atualizações do Windows 2000 SP4; Windows XP |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |