WdfDeviceRetrieveDeviceName 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceRetrieveDeviceName 메서드는 지정된 디바이스의 디바이스 이름을 반환합니다.

구문

NTSTATUS WdfDeviceRetrieveDeviceName(
  [in] WDFDEVICE Device,
  [in] WDFSTRING String
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] String

디바이스 이름을 수신하는 프레임워크 문자열 개체에 대한 핸들입니다.

반환 값

작업이 성공하면 WdfDeviceRetrieveDeviceName 은 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 잘못된 매개 변수가 감지되었습니다.
 

메서드는 다른 NTSTATUS 값을 반환할 수 있습니다.

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

설명

WdfDeviceRetrieveDeviceName 메서드는 WdfDeviceInitAssignName에 대한 이전 호출에서 드라이버가 지정한 디바이스 이름을 반환합니다.

문자열 개체에서 디바이스 이름 문자열을 가져오려면 드라이버는 WdfStringGetUnicodeString을 호출할 수 있습니다.

예제

다음 코드 예제에서는 문자열 개체를 만든 다음 지정된 디바이스의 이름을 검색합니다.

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;
    }
}

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfDeviceInitAssignName

WdfDeviceQueryProperty

WdfStringCreate