피드백

IoSetDeviceInterfacePropertyData 함수(wdm.h)

  • 아티클
  • 읽는 데 3분 걸림

IoSetDeviceInterfacePropertyData 루틴은 디바이스 인터페이스 속성의 현재 값을 수정합니다.

구문

NTSTATUS IoSetDeviceInterfacePropertyData(
  [in]           PUNICODE_STRING  SymbolicLinkName,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           LCID             Lcid,
  [in]           ULONG            Flags,
  [in]           DEVPROPTYPE      Type,
  [in]           ULONG            Size,
  [in, optional] PVOID            Data
);

매개 변수

[in] SymbolicLinkName

디바이스 인터페이스 인스턴스를 식별하는 문자열에 대한 포인터입니다. 이 문자열은 IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias 또는 IoRegisterDeviceInterface 루틴에 대한 이전 호출에서 얻은 것입니다.

[in] PropertyKey

디바이스 인터페이스 속성 키가 포함된 DEVPROPKEY 구조체에 대한 포인터입니다.

[in] Lcid

로캘 식별자를 지정합니다. 이 매개 변수를 언어별 LCID 값으로 설정하거나 LOCALE_NEUTRAL. LOCALE_NEUTRAL LCID는 속성이 언어 중립적임을 지정합니다(즉, 어떤 언어와도 관련이 없음). 이 매개 변수를 LOCALE_SYSTEM_DEFAULT 또는 LOCALE_USER_DEFAULT 설정하지 마세요. 언어별 LCID 값에 대한 자세한 내용은 LCID 구조를 참조하세요.

[in] Flags

이 루틴에서 설정한 속성 값이 컴퓨터 다시 시작에서 유지되어야 하는 경우 이 매개 변수를 PLUGPLAY_PROPERTY_PERSISTENT 설정합니다. 그렇지 않으면 플래그 를 0으로 설정합니다.

[in] Type

이 매개 변수를 데이터 버퍼에 제공된 데이터의 형식을 지정하는 DEVPROPTYPE 값으로 설정합니다.

[in] Size

데이터가 가리키는 버퍼의 크기(바이트)를 지정합니다.

[in, optional] Data

디바이스 인터페이스 속성 데이터에 대한 포인터입니다. 지정된 속성을 삭제하려면 이 매개 변수를 NULL 로 설정합니다. 데이터가 NULL 이 아닌 경우 루틴은 속성 값의 내부 복사본을 저장합니다. 데이터가 가리키는 버퍼는 호출이 반환된 후에도 유효한 상태를 유지할 필요가 없습니다.

반환 값

IoSetDeviceInterfacePropertyData 는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 코드 설명
STATUS_UNSUCCESSFUL 지정된 LCID 값이 잘못되었습니다.
STATUS_NOT_IMPLEMENTED 지정된 속성은 지원되지 않습니다.

설명

커널 모드 드라이버는 IoSetDeviceInterfacePropertyData 루틴을 사용하여 통합 디바이스 속성 모델의 일부로 정의된 디바이스 인터페이스 속성을 수정합니다. 디바이스 인터페이스 속성에 대한 자세한 내용은 디바이스 속성을 참조하세요.

드라이버는 IoGetDeviceInterfacePropertyData 루틴을 사용하여 디바이스 인터페이스 속성에 대한 현재 값을 가져올 수 있습니다.

IoSetDeviceInterfacePropertyData 의 호출자는 시스템 스레드의 컨텍스트에서 IRQL <= APC_LEVEL 실행되어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 이상 버전의 Windows 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

참고 항목

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData