Função WdfDeviceRetrieveDeviceDirectoryString (wdfdevice.h)

[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.