DOT11EXT_SEND_PACKET 콜백 함수(wlanihv.h)

  • 아티클
중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
 
IHV 확장 DLL은 Dot11ExtSendPacket 함수를 호출하여 WLAN(무선 LAN) 어댑터를 통해 패킷을 전송합니다.

구문

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

운영 체제에서 WLAN 어댑터를 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 지정되었습니다.

[in] uPacketLen

pvPacket 매개 변수에서 참조하는 호출자가 할당한 버퍼의 길이(바이트)입니다.

[in] pvPacket

주의 섹션에 설명된 대로 전송할 데이터를 포함하는 호출자가 할당한 버퍼에 대한 포인터입니다.

[in, optional] hSendCompletion

송신 패킷을 고유하게 식별하는 핸들 값입니다.

WLAN 어댑터가 송신 작업을 완료하면 운영 체제는 에 대한 호출을 통해 IHV 확장 DLL에 알릴 수 있습니다. Dot11ExtIhvSendPacketCompletion IHV 처리기 함수입니다. 이 호출을 수행할 때 운영 체제는 hSendCompletion 매개 변수를 통해 패킷의 핸들 값을 전달합니다.

반환 값

호출이 성공하면 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

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

  • Dot11ExtSendPacket 함수의 호출을 통해 전송된 패킷은 비동기적으로 완료됩니다. IHV 확장 DLL은 다음까지 pvPacket 매개 변수에서 참조하는 메모리를 해제해서는 안 됩니다. Dot11ExtIhvSendPacketCompletion IHV 처리기 함수는 hSendCompletion 매개 변수와 동일한 핸들 값을 사용하여 호출됩니다.
  • IHV 확장 DLL은 hSendCompletion 매개 변수를 pvPacket 매개 변수에서 참조하는 패킷 데이터를 고유하게 식별하는 값으로 설정해야 합니다.
IHV 처리기 함수에 대한 자세한 내용은 네이티브 802.11 IHV 처리기 함수를 참조하세요.

pvPacket에서 가리키는 버퍼에는 네트워크 바이트 순서로 지정된 다음 패킷 데이터가 포함되어야 합니다.

  • 802.11 MAC 헤더 관리에 설명된 지침에 따라 서식이 지정된 대상의 MAC 주소(6바이트)
  • IEEE EtherType(2바이트)
  • 페이로드
이 패킷 데이터는 미니포트 드라이버에 전달됩니다.

요구 사항

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

추가 정보

네이티브 802.11 IHV 처리기 함수

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 MAC 헤더 관리