Função WdfDeviceRetrieveDeviceName (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfDeviceRetrieveDeviceName retorna o nome do dispositivo para um dispositivo especificado.
Sintaxe
NTSTATUS WdfDeviceRetrieveDeviceName(
[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 que recebe o nome do dispositivo.
Valor de retorno
Se a operação for bem-sucedida, WdfDeviceRetrieveDeviceName retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:
| Código de retorno | Descrição |
|---|---|
|
Um parâmetro inválido foi detectado. |
O método pode retornar outros valores NTSTATUS .
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
O método WdfDeviceRetrieveDeviceName retorna o nome do dispositivo especificado pelo driver em uma chamada anterior para WdfDeviceInitAssignName.
Para obter a cadeia de caracteres de nome do dispositivo do objeto de cadeia de caracteres, o driver pode chamar WdfStringGetUnicodeString.
Exemplos
O exemplo de código a seguir cria um objeto de cadeia de caracteres e recupera o nome de um dispositivo especificado.
NTSTATUS status;
WDFSTRING string;
status = WdfStringCreate(
NULL,
WDF_NO_OBJECT_ATTRIBUTES,
&string
);
if (NT_SUCCESS(status)) {
status = WdfDeviceRetrieveDeviceName(
Device,
string
);
if (!NT_SUCCESS(status)) {
return status;
}
}
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |