다음을 통해 공유


OID_NDK_SET_STATE

설정된 요청으로 NDIS 및 오버리싱 드라이버는 OID_NDK_SET_STATE OID를 사용하여 미니포트 어댑터의 NDK 기능 상태를 설정합니다.

NDK 서비스를 제공하는 NDIS 6.30 이상 미니포트 드라이버는 이 OID를 지원해야 합니다. 그렇지 않으면 이 OID는 선택 사항입니다.

설명

NDIS는 sizeof(BOOLEAN)와 동일한 BOOLEANInformationBufferLength 멤버를 가리키는 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 이 OID를 발급합니다.

  • BOOLEAN 값이 TRUE이고 *NetworkDirect 키워드(keyword) 값이 0이 아니면 미니포트 어댑터의 NDK 기능을 사용하도록 설정해야 합니다.

    미니포트 드라이버는 다음을 수행하여 *NetworkDirect 키워드(keyword) 값을 읽을 수 있습니다.

    1. 미니포트 드라이버가 초기화되었을 때 NdisMRegisterMiniportDriver 함수가 반환한 NDIS 핸들을 사용하여 NdisOpenConfigurationEx를 호출합니다. NdisOpenConfigurationEx를 호출하는 방법에 대한 자세한 내용은 NDIS 6.0 미니포트 드라이버에서 레지스트리 읽기를 참조하세요.

    2. 다음을 전달하여 NdisReadConfiguration을 호출합니다.

      • Keyword 매개 변수에 대한 "*NetworkDirect"

      • ParameterType 매개 변수에 대한 NdisParameterInteger

  • BOOLEAN 값이 FALSE이면 미니포트 어댑터의 NDK 기능을 사용하지 않도록 설정해야 합니다.

NDK 기능을 사용하거나 사용하지 않도록 설정하려면 미니포트 드라이버의 MiniportOidRequest 콜백 함수는 NDK 기능 사용 및 사용 안 함의 단계를 따라야 합니다.

참고 이렇게 하면 교착 상태가 발생할 수 있으므로 NDK 지원 미니포트 드라이버는 MiniportOidRequest 함수의 컨텍스트에서 NdisMNetPnPEvent를 호출해서는 안 됩니다. 대신 다른 컨텍스트에서 NdisMNetPnPEvent 를 호출하거나 작업 항목을 큐에 추가해야 합니다.

NDK 지원 미니포트 드라이버의 MiniportOidRequest 함수는 오류가 발생하지 않는 한 OID_NDK_SET_STATE OID 요청에 대한 STATUS_SUCCESS 반환해야 합니다. 드라이버는 NDIS_STATUS_PENDING 반환하지 않아야 합니다.

요구 사항

지원되는 최소 클라이언트

지원되는 버전 없음

지원되는 최소 서버

Windows Server 2012

버전

NDIS 6.30 이상에서 지원됩니다.

헤더

Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE