Função WdfDeviceRetrieveDeviceDirectoryString (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao UMDF]

WdfDeviceRetrieveDeviceDirectoryString fornece um caminho para um local no disco que pode ser usado para manter 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 da estrutura . A estrutura atribuirá o caminho do diretório ao objeto de cadeia de caracteres no retorno bem-sucedido.

Valor de retorno

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

Observações

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

Consulte também

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

Compartilhar via