DOT11EXT_ALLOCATE_BUFFER 콜백 함수(wlanihv.h)

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

IHV 확장 DLL은 Dot11ExtAllocateBuffer 함수를 호출하여 가변 길이 버퍼에 대한 메모리를 할당합니다.

구문

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

DWORD Dot11extAllocateBuffer(
  [in]  DWORD dwByteCount,
  [out] LPVOID *ppvBuffer
)
{...}

[in] dwByteCount

할당할 버퍼의 크기(바이트)입니다.

[out] ppvBuffer

할당된 버퍼의 주소를 저장하는 호출자 제공 변수에 대한 포인터입니다. 반환 값이 ERROR_SUCCESS 경우 ppvBuffer 매개 변수에는 유효한 null이 아닌 값이 있습니다.

호출은 Winerror.h에 정의된 ERROR_xxxx 코드를 반환합니다. 다음 ERROR_xxxx 코드는 일반적으로 Dot11ExtAllocateBuffer 함수에서 반환됩니다.

반환 코드	설명
ERROR_SUCCESS	오류 없이 호출이 성공했습니다.
ERROR_OUTOFMEMORY	운영 체제가 리소스 부족으로 인해 메모리를 할당할 수 없습니다.

IHV 확장 DLL은 Dot11ExtAllocateBuffer 함수를 호출할 때 다음 지침을 따라야 합니다.

IHV 처리기 함수에서 가변 길이 버퍼를 반환할 때 IHV 확장 DLL은 이 함수를 호출해야 합니다. 이 경우 운영 체제는 IHV 처리기 함수를 반환한 후 버퍼를 해제해야 합니다.
IHV 처리기 함수에 대한 자세한 내용은 네이티브 802.11 IHV 처리기 함수를 참조하세요.
IHV 확장 DLL은 DLL 자체에서 참조하는 메모리를 할당하기 위해 이 함수를 호출할 수 있습니다.
이 경우 DLL은 Dot11ExtFreeBuffer를 호출하여 메모리 버퍼를 해제해야 합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	wlanihv.h(Wlanihv.h 포함)