WdfStringGetUnicodeString 함수(wdfstring.h)

[KMDF 및 UMDF에 적용]

WdfStringGetUnicodeString 메서드는 지정된 프레임워크 문자열 개체에 할당된 유니코드 문자열을 검색합니다.

구문

void WdfStringGetUnicodeString(
  [in]  WDFSTRING       String,
  [out] PUNICODE_STRING UnicodeString
);

매개 변수

[in] String

프레임워크 문자열 개체에 대한 핸들입니다.

[out] UnicodeString

String에서 지정하는 문자열 개체에 현재 할당된 유니코드 문자열에 대한 포인터를 수신하는 UNICODE_STRING 구조체에 대한 포인터입니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

WdfStringGetUnicodeString이 반환된 후 UnicodeString이 가리키는 UNICODE_STRING 구조체에는 문자열의 길이와 함께 지정된 문자열 개체의 유니코드 문자열에 대한 포인터가 포함됩니다. 유니코드 문자열은 페이징 풀에 할당됩니다.

프레임워크는 드라이버에 대한 문자열의 복사본을 만들지 않습니다.

프레임워크 문자열 개체에 대한 자세한 내용은 문자열 개체 사용을 참조하세요.

예제

다음 코드 예제에서는 지정된 프레임워크 문자열 개체에 할당된 유니코드 문자열을 가져옵니다.

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfstring.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

UNICODE_STRING

WdfStringCreate