Compartilhar via

Função WdfDeviceRetrieveDeviceDirectoryString (wdfdevice.h)

  • Artigo

[Aplica-se somente ao UMDF]

WdfDeviceRetrieveDeviceDirectoryString fornece um caminho para um local no disco que pode ser usado para persistir informações entre reinicializações.

Sintaxe

NTSTATUS WdfDeviceRetrieveDeviceDirectoryString(
  [_In_] WDFDEVICE Device,
  [_In_] WDFSTRING String
);

Parâmetros

[_In_] Device

Um identificador para um objeto de dispositivo de estrutura.

[_In_] String

Um identificador para um objeto de cadeia de caracteres de estrutura. A estrutura atribuirá o caminho do diretório ao objeto de cadeia de caracteres no retorno bem-sucedido.

Retornar valor

Essa função retorna NTSTATUS. WdfDeviceRetrieveDeviceDirectoryString retorna STATUS_SUCCESS se a operação for bem-sucedida.

Comentários

Somente UMDF. Os drivers KMDF devem usar IoGetDeviceDirectory.

Requisitos

Requisito Valor
Versão mínima do UMDF 2.25
Cabeçalho wdfdevice.h
IRQL PASSIVE_LEVEL

Confira também

Para obter informações sobre objetos de cadeia de caracteres, consulte Usando objetos string.