StorPortInterlockedInsertHeadList 함수(storport.h)

아티클
08/07/2023

StorPortInterlockedInsertHeadList 루틴은 두 배로 연결된 STOR_LIST_ENTRY 구조 목록의 시작 부분에 항목을 원자적으로 삽입합니다.

구문

ULONG StorPortInterlockedInsertHeadList(
  [in]      PVOID            HwDeviceExtension,
  [in, out] PSTOR_LIST_ENTRY ListHead,
  [in, out] PSTOR_LIST_ENTRY ListEntry,
  [in, out] PSTOR_LIST_ENTRY *Result,
  [in, out] PSTOR_KSPIN_LOCK Lock
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

[in, out] ListHead

목록의 헤드를 나타내는 STOR_LIST_ENTRY 구조체에 대한 포인터입니다.

[in, out] ListEntry

목록에 삽입할 항목을 나타내는 STOR_LIST_ENTRY 구조체에 대한 포인터입니다.

[in, out] Result

새 항목을 삽입하기 전에 목록의 첫 번째 항목을 나타내는 STOR_LIST_ENTRY 구조체에 대한 포인터입니다.

[in, out] Lock

목록에 대한 액세스를 동기화하는 데 사용되는 스핀 잠금 역할을 하는 STOR_KSPIN_LOCK 구조체에 대한 포인터입니다. 스핀 잠금에 대한 스토리지는 상주해야 하며 StorPortInitializeSpinLock을 호출하여 초기화되어야 합니다.

StorPortInterlockedXxx목록 루틴에서만 이 스핀 잠금을 사용해야 합니다.

반환 값

StorPortInterlockedInsertHeadList는 다음 중 하나와 같은 상태 코드를 반환합니다.

반환 코드	설명
STOR_STATUS_NOT_IMPLEMENTED	이 함수는 활성 운영 체제에서 구현되지 않습니다.
STOR_STATUS_SUCCESS	목록 항목이 성공적으로 제거되었거나 목록이 이미 비어 있습니다.
STOR_STATUS_INVALID_PARAMETER	ListHead 또는 Result의 포인터는 NULL입니다.