IOCTL_STORAGE_SET_PROPERTY IOCTL(ntddstor.h)

아티클
02/06/2022
읽는 데 2분 걸림

드라이버는 IOCTL_STORAGE_SET_PROPERTY 사용하여 스토리지 디바이스 또는 어댑터의 속성을 설정할 수 있습니다.

참고

Windows 10 버전 2004에서 IOCTL 정의가 충돌하여 IOCTL_STORAGE_SET_PROPERTY 사용하는 기존 소프트웨어를 Windows Server 2022에서 다시 컴파일해야 합니다.

주 코드

입력 버퍼

수행 중인 집합의 형식, 설정되는 속성 및 특정 속성 집합에 필요한 추가 매개 변수를 설명하는 STORAGE_PROPERTY_SET 구조체 를 포함합니다. 추가 속성이 있는 구조체는 STORAGE_PROPERTY_SET PropertyId 에 따라 STORAGE_PROPERTY_SET 구조체 바로 다음에 찾을 수 있습니다. 예를 들어 PropertyId 가 StorageAdapterProtocolSpecificProperty 인 경우 STORAGE_PROTOCOL_SPECIFIC_DATA_EXT 구조체는 바로 STORAGE_PROPERTY_SET 따릅니다.

입력 버퍼 길이

Parameters.DeviceIoControl.InputBufferLength 는 Irp->AssociatedIrp.SystemBuffer 에서 매개 변수 버퍼의 크기(바이트)를 나타내며, >= sizeof(STORAGE_PROPERTY_SET)여야 합니다.

출력 버퍼

지정된 PropertyId 에 따라 다릅니다. 예를 들어 PropertyId 가 StorageAdapterProtocolSpecificProperty 인 경우 출력 버퍼에는 미니포트의 업데이트된 데이터가 포함된 STORAGE_PROTOCOL_SPECIFIC_DATA_EXT 구조체가 포함됩니다.

출력 버퍼 길이

출력 버퍼의 크기(바이트)입니다.

상태 블록

요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태입니다. 자세한 내용은 NTSTATUS 값을 참조하세요.

요구 사항


헤더	ntddstor.h

참조

STORAGE_PROPERTY_SET

STORAGE_PROTOCOL_SPECIFIC_DATA_EXT

STORAGE_SET_TYPE