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) |