Função WdfDriverRetrieveDriverDataDirectoryString (wdfdriver.h)
[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 |