Função WdfStringGetUnicodeString (wdfstring.h)

  • Artigo

[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 UNICODE_STRING que recebe um ponteiro para a cadeia de caracteres Unicode que está atualmente atribuída ao objeto de cadeia de caracteres especificado por String .

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Depois que WdfStringGetUnicodeString retornar, o UNICODE_STRING estrutura para a qual UnicodeString aponta contém 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 de 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
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)

Confira também

UNICODE_STRING

WdfStringCreate