MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수(dot11wdi.h)

아티클
02/06/2025

중요하다

이 항목은 Windows 10에서 릴리스된 WDI 드라이버 모델 일부입니다. WDI 드라이버 모델은 유지 관리 모드이며 높은 우선 순위 수정만 받습니다. WiFiCx Windows 11에서 릴리스된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다.

MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수는 불투명한 대상 TX 설명자를 NET_BUFFER_LIST(MiniportReserved[1] 필드)와 연결하고(해당하는 경우) NET_BUFFER_LIST(MiniportReserved[0])의 WDI_FRAME_METADATA 버퍼에서 TX 비용 필드(크레딧 단위)를 채웁니다.

NDIS_MINIPORT_WDI_DATA_HANDLERS내의 WDI 미니포트 처리기입니다.

참고MINIPORT_WDI_TX_TARGET_DESC_INIT 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

통사론

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

매개 변수

[in] MiniportTalTxRxContext

MINIPORT_WDI_TAL_TXRX_INITIALIZE 콜백 함수에서 IHV 미니포트에서 반환된 TAL 디바이스 핸들입니다.

[in] pNBL

단일 NET_BUFFER_LIST대한 포인터입니다.

[out] pWifiStatus

MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수의 결과를 나타내기 위해 IHV에서 설정한 상태에 대한 포인터입니다.

반환 값

없음

발언

NDIS_STATUS_RESOURCES 상태는 Tx 설명자가 소진된 경우에만 사용해야 합니다. IHV 미니포트에서 NDIS_STATUS_RESOURCES사용하지 않는 경우 최상의 동작이 발생합니다. IHV 미니포트 또는 펌웨어가 NET_BUFFER_LIST처리할 수 없음을 나타내는 다른 오류에는 NDIS_STATUS_SUCCESS 및 NDIS_STATUS_RESOURCES 이외의 상태를 사용해야 합니다.

IHV 미니포트는 적절한 NDIS 후퇴 및 고급 기능을 사용하여 NET_BUFFER 백필을 활용할 수 있습니다. 패킷 오프셋의 시작은 MINIPORT_WDI_TX_TARGET_DESC_DEINIT 콜백 함수 이전 또는 MINIPORT_WDI_TX_TARGET_DESC_DEINIT 복원해야 합니다. TxMgr은 큐에서 제거 시간 동안 프레임 길이를 결정하므로 MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수의 프레임 길이 변경은 큐에서 제거 크기를 양자로 제한하는 데 포함됩니다. 이 경우 IHV 미니포트는 델타를 고려하여 양자를 적절하게 조정해야 합니다.

중요 IHV 미니포트는 이 호출의 컨텍스트에서 어떠한 표시도 할 수 없습니다. TxMgr은 TxTargetDescInitHandler 호출을 직렬화합니다.

예제

MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수를 정의하려면 먼저 정의하는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 "MyTxTargetDescInit"라는 MINIPORT_WDI_TX_TARGET_DESC_INIT 콜백 함수를 정의하려면 다음 코드 예제와 같이 MINIPORT_WDI_TX_TARGET_DESC_INIT 형식을 사용합니다.

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

MINIPORT_WDI_TX_TARGET_DESC_INIT 함수 형식은 dot11wdi.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 MINIPORT_WDI_TX_TARGET_DESC_INIT 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.