Função IoGetDiskDeviceObject (ntifs.h)

  • Artigo

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
STATUS_INVALID_PARAMETER
 Um dos parâmetros passados para essa função era inválido.
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

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

Confira também

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject