Função WdfDriverRetrieveDriverDataDirectoryString (wdfdriver.h)

  • Artigo

[Aplica-se somente ao UMDF]

O método WdfDriverRetrieveDriverDataDirectoryString retorna um caminho para um diretório no disco no qual o driver pode armazenar informações. Os arquivos nesse diretório se aplicam a um objeto de driver de estrutura específico.

Sintaxe

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

Parâmetros

[_In_] Driver

Um identificador para o objeto de driver de estrutura do driver que o driver obteve de uma chamada anterior para WdfDriverCreate ou WdfDeviceGetDriver.

[_In_] String

Um identificador para um objeto de cadeia de caracteres de estrutura que o driver obteve de uma chamada anterior para WdfStringCreate. A estrutura atribui o caminho totalmente qualificado do diretório de driver solicitado ao objeto de cadeia de caracteres.

Retornar valor

WdfDriverRetrieveDriverDataDirectoryString retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método retornará um código de erro NTSTATUS apropriado. Para obter mais informações, consulte Valores NTSTATUS.

Comentários

Para obter o mesmo resultado, um driver KMDF deve chamar IoGetDriverDirectory .

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

Exemplos

O exemplo de código a seguir mostra como chamar WdfDriverRetrieveDriverDataDirectoryString:

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveDriverDataDirectoryString(
                         Driver,
                         string
                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

Requisitos

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

Confira também

IoGetDriverDirectory

Enumeração _DRIVER_DIRECTORY_TYPE