Share via


OID_802_11_MEDIA_STREAM_MODE

When set, the OID_802_11_MEDIA_STREAM_MODE OID requests the miniport driver to enter media streaming mode or exit media streaming mode.

When queried, this OID requests that the miniport driver return its current media streaming status.

The data passed in a query or setting of this OID is the NDIS_802_11_MEDIA_STREAM_MODE enumeration, which defines the following values:

  • Ndis802_11MediaStreamOff
    Media streaming is disabled. The driver must always disable media streaming and return NDIS_STATUS_SUCCESS when set to this mode. The driver can then resume any self-initiated 802.11 operations that it disabled before entering media streaming mode.

    Note   The miniport driver must set its media streaming mode to Ndis802_11MediaStreamOff from within its MiniportInitialize function.

     

  • Ndis802_11MediaStreamOn
    Media streaming is enabled.

When in media streaming mode, the miniport driver must avoid any self-initiated 802.11 operations that could impact transmit and receive throughput. For example, the driver must not perform any radio power management operation or background scanning on its own while in this mode.

However, if the miniport driver is requested (through the setting of an OID) to perform an 802.11 operation that impacts transmit and receive throughput, the driver must temporarily override media streaming mode and perform the requested operation. After processing the set request, the driver must resume the current media streaming mode.

For example, if OID_802_11_BSSID_LIST_SCANis set, the driver must override media streaming mode until the scan is completed. If the miniport is requested to perform other 802.11 operations before the first-requested operation (in this case, the scan) is completed, the miniport driver must continue to override media streaming mode until it has completed all requested operations.

If the miniport is not currently associated, it must fail the set request for Ndis802_11MediaStreamOn and return NDIS_STATUS_ADAPTER_NOT_READY.

If the device is currently performing an 802.11 operation that would affect media streaming, then the miniport driver must do the following when this OID is set:

  • If the device is performing an explicit scan operation that was requested through a set of OID_802_11_BSSID_LIST_SCAN, the miniport driver must return NDIS_STATUS_PENDING. The driver must complete the set by calling NdisMSetInformationComplete after the scan operation has been completed.

  • If the device is performing an implicit scan operation, the miniport driver must cancel the scan operation and complete the set of this OID

If the device is unable to operate in Ndis802_11MediaStreamOn mode for any reason, the driver must return NDIS_STATUS_FAILURE.

For more information about 802.11 media streaming, see Media Streaming.

 

 

Send comments about this topic to Microsoft