Função WdfStringGetUnicodeString (wdfstring.h)
[Aplica-se a KMDF e UMDF]
O método WdfStringGetUnicodeString recupera a cadeia de caracteres Unicode atribuída a um objeto de cadeia de caracteres de estrutura especificado.
Sintaxe
void WdfStringGetUnicodeString(
[in] WDFSTRING String,
[out] PUNICODE_STRING UnicodeString
);
Parâmetros
[in] String
Um identificador para um objeto de cadeia de caracteres de estrutura.
[out] UnicodeString
Um ponteiro para uma estrutura de UNICODE_STRING que recebe um ponteiro para a cadeia de caracteres Unicode que está atualmente atribuída ao objeto de cadeia de caracteres que string especifica.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Depois que wdfStringGetUnicodeString retorna, a estrutura UNICODE_STRING que UnicodeString aponta para conter um ponteiro para a cadeia de caracteres Unicode do objeto de cadeia de caracteres especificada, juntamente com o comprimento da cadeia de caracteres. A cadeia de caracteres Unicode é alocada no pool de páginas.
A estrutura não faz uma cópia da cadeia de caracteres para o driver.
Para obter mais informações sobre objetos de cadeia de caracteres da estrutura, consulte Usando objetos de cadeia de caracteres.
Exemplos
O exemplo de código a seguir obtém a cadeia de caracteres Unicode atribuída a um objeto de cadeia de caracteres de estrutura especificado.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfstring.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |