StorPortInterlockedRemoveHeadList 함수(storport.h)

아티클
08/07/2023

StorPortInterlockedRemoveHeadList 루틴은 두 배로 연결된 STOR_LIST_ENTRY 구조 목록의 시작 부분에서 항목을 제거합니다.

구문

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

매개 변수

[in] HwDeviceExtension

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

[in, out] ListHead

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

[in, out] Result

목록에서 제거된 항목을 나타내는 STOR_LIST_ENTRY 구조체에 대한 포인터입니다. 목록이 비어 있으면 루틴은 NULL을 반환합니다.

[in, out] Lock

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

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

반환 값

StorPortInterlockedRemoveHeadList는 다음 상태 코드 중 하나를 반환합니다.

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