IoSetDeviceInterfacePropertyData 함수(wdm.h)

  • 아티클

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

디바이스 인터페이스 instance 식별하는 문자열에 대한 포인터입니다. 이 문자열은 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 로 설정합니다. Data가 NULL이 아닌 경우 루틴은 속성 값의 내부 복사본을 저장합니다. 호출이 반환된 후에도 Data 가 가리키는 버퍼가 유효한 상태를 유지할 필요가 없습니다.

반환 값

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