WdfDeviceInitAssignName 함수(wdfdevice.h)

[KMDF에만 적용]

WdfDeviceInitAssignName 메서드는 디바이스 이름을 디바이스의 디바이스 개체에 할당합니다.

구문

NTSTATUS WdfDeviceInitAssignName(
  [in]           PWDFDEVICE_INIT  DeviceInit,
  [in, optional] PCUNICODE_STRING DeviceName
);

매개 변수

[in] DeviceInit

WDFDEVICE_INIT 구조체에 대한 포인터입니다.

[in, optional] DeviceName

디바이스 이름을 나타내는 UNICODE_STRING 구조체에 대한 포인터입니다.

반환 값

WdfDeviceInitAssignName에서 오류가 발생하지 않으면 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드	설명
STATUS_INSUFFICIENT_RESOURCES	시스템에서 디바이스 이름을 저장할 공간을 할당할 수 없습니다.

설명

드라이버가 WdfDeviceInitAssignName을 호출하는 경우 WdfDeviceCreate를 호출하기 전에 호출해야 합니다.

드라이버가 WdfDeviceInitAssignName을 호출하여 이름을 할당하는 경우 드라이버는 이후에 NULLDeviceName 매개 변수를 사용하여 WdfDeviceInitAssignName을 호출하여 디바이스 이름을 지울 수 있습니다. 디바이스 이름이 NULL 이고 디바이스 개체에 이름이 필요한 경우(PDO 또는 제어 디바이스를 나타내기 때문에) 운영 체제에서 이름을 만듭니다.

디바이스 개체의 이름을 지정하는 방법에 대한 자세한 내용은 Framework-Based 드라이버에서 디바이스 액세스 제어를 참조하세요.

WdfDeviceCreate를 호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.

예제

다음 코드 예제에서는 디바이스에 NT 디바이스 이름을 할당합니다.

DECLARE_CONST_UNICODE_STRING(MyDeviceName, L"\\Device\\Ramdisk") ;
status = WdfDeviceInitAssignName(
                                 DeviceInit,
                                 &MyDeviceName
                                 );
if (!NT_SUCCESS(status)) {
    return status;
}

요구 사항

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

추가 정보

WdfDeviceRetrieveDeviceName