StorPortRegistryWrite 함수(storport.h)

  • 아티클

StorPortRegistryWrite 루틴은 미니포트 드라이버가 지정된 버퍼에 포함된 레지스트리 데이터를 ASCII에서 유니코드로 변환한 다음, 미니포트 드라이버의 HBA 스토리지 영역에 데이터를 쓰기 위해 호출됩니다.

구문

STORPORT_API BOOLEAN StorPortRegistryWrite(
  [in] PVOID  HwDeviceExtension,
  [in] PUCHAR ValueName,
  [in] ULONG  Global,
  [in] ULONG  Type,
  [in] PUCHAR Buffer,
  [in] ULONG  BufferLength
);

매개 변수

[in] HwDeviceExtension

하드웨어 디바이스 확장에 대한 포인터입니다. 포트 드라이버가 미니포트 드라이버를 대신하여 할당하고 초기화하는 HBA 스토리지 영역당 입니다. 미니포트 드라이버는 일반적으로 HBA 상태 및 HBA에 대한 매핑된 액세스 범위와 같은 HBA 관련 정보를 이 확장에 저장합니다. 이 영역은 미니포트 드라이버가 StorPortInitialize를 호출한 직후 미니포트 드라이버에서 사용할 수 있습니다. 포트 드라이버는 디바이스를 제거할 때 이 메모리를 해제합니다. 미니포트 드라이버는 이 루틴을 호출할 때 IRQL PASSIVE_LEVEL 실행되어야 합니다.

[in] ValueName

값 이름을 지정하는 문자열에 대한 포인터입니다.

[in] Global

작업이 어댑터별인지 아니면 모든 어댑터와 관련이 있는지 여부를 나타냅니다.

[in] Type

다음 레지스트리 데이터 형식 중 하나입니다.

Type 의미
REG_SZ 유니코드 null로 종료된 문자열입니다.
REG_EXPAND_SZ 환경 변수 참조를 사용하여 null로 끝나는 유니코드 문자열입니다.
REG_BINARY 이진 데이터.
REG_DWORD 32비트 이중 단어입니다.
REG_DWORD_LITTLE_ENDIAN little-endian 형식의 32비트 이중 단어입니다.
REG_DWORD_BIG_ENDIAN big-endian 형식의 32비트 이중 단어입니다.
REG_LINK 기호 링크를 지정하는 유니코드 문자열입니다.
REG_MULTI_SZ 여러 유니코드 문자열.
REG_RESOURCE_LIST 리소스 맵의 리소스 목록입니다.
REG_FULL_RESOURCE_DESCRIPTOR 하드웨어 설명의 리소스 목록입니다.
REG_RESOURCE_REQUIREMENTS_LIST 리소스 요구 사항 목록입니다.
REG_QWORD 64비트 쿼드렛 번호입니다.
REG_QWORD_LITTLE_ENDIAN little-endian 형식의 64비트 쿼드렛 번호입니다.

[in] Buffer

쓸 레지스트리 데이터가 포함된 버퍼에 대한 포인터입니다.

[in] BufferLength

버퍼가 가리키는 버퍼의 크기를 지정합니다.

반환 값

레지스트리 데이터가 성공적으로 변환되고 기록된 경우 StorPortRegistryWrite는 TRUE의 부울 값을 반환합니다. 그렇지 않으면 이 루틴은 FALSE를 반환합니다.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
헤더 storport.h(Storport.h 포함)
라이브러리 Storport.lib
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 StorPortIrql(storport)

추가 정보

StorPortInitialize