MINIPORT_DIRECT_OID_REQUEST callback function (ndis.h)
NDIS calls a miniport driver's MiniportDirectOidRequest function to handle a direct OID request to query or set information in the driver.
Syntax
MINIPORT_DIRECT_OID_REQUEST MiniportDirectOidRequest;
NDIS_STATUS MiniportDirectOidRequest(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] PNDIS_OID_REQUEST OidRequest
)
{...}
Parameters
[in] MiniportAdapterContext
A handle to a context area that the miniport driver allocated in its MiniportInitializeEx function. The miniport driver uses this context area to maintain state information for a miniport adapter.
[in] OidRequest
A pointer to an NDIS_OID_REQUEST structure that contains both the buffer and the request packet for the miniport driver to handle. Depending on the request, the driver returns requested information in the structure that is provided.
Return value
MiniportDirectOidRequest can return one of the following status values:
Return code | Description |
---|---|
|
The miniport driver set or obtained the data as requested. |
|
The miniport driver will complete the request asynchronously. After the miniport driver has completed all processing, it must call the NdisMDirectOidRequestComplete function to inform NDIS that the request is complete. |
|
The request that OidRequest specified was invalid or not recognized. |
|
The request that OidRequest specified was recognized, but the miniport driver does not support it. |
|
The buffer that OidRequest supplies was too small to hold the requested data. |
|
The value that was specified in the InformationBufferLength member of the NDIS_OID_REQUEST structure at OidRequest is incorrect for the specified OID_Xxx code. |
|
One or more of the parameters that were specified for the request at OidRequest were invalid. |
|
After calling the MiniportDevicePnPEventNotify function to indicate a surprise removal, NDIS called the driver's MiniportHaltEx function. If the driver received any OID requests before NDIS calls MiniportHaltEx, it should immediately complete such requests with a status value of NDIS_STATUS_NOT_ACCEPTED. |
|
The miniport driver stopped processing the request. For example, NDIS called the MiniportResetEx function. |
|
The miniport driver will provide an OID completion status with a subsequent status indication. A miniport driver cannot return NDIS_STATUS_INDICATION_REQUIRED unless the particular OID allows it. To determine if this status is allowed, see the OID reference page.. For more information about NDIS_STATUS_INDICATION_REQUIRED, see NDIS_OID_REQUEST and NDIS_STATUS_INDICATION. |
Remarks
MiniportDirectOidRequest is an optional function. A miniport driver registers this function if it handles direct OID requests. A driver specifies the MiniportDirectOidRequest entry point when it calls the NdisMRegisterMiniportDriver function. A miniport driver that registers the MiniportCancelDirectOidRequest function must also register MiniportDirectOidRequest.
NDIS calls the MiniportDirectOidRequest function either on its own behalf or on behalf of a bound protocol driver that called the NdisDirectOidRequest function. Miniport drivers should examine the request that is supplied at the OidRequest parameter and take the action requested.
Note that NDIS does not validate the OID-specific contents at OidRequest. Therefore, the driver itself must validate these contents. If the driver determines that the value to be set is out of bounds, it should fail the request and return NDIS_STATUS_INVALID_DATA.
NDIS does not serialize requests that it sends to MiniportDirectOidRequest with other OID requests. The miniport driver must be able to handle multiple calls to MiniportDirectOidRequest when other requests that are sent to MiniportOidRequest or MiniportDirectOidRequest are outstanding.
Examples
To define a MiniportDirectOidRequest function, you must first provide a function declaration that identifies the type of function you're defining. Windows provides a set of function types for drivers. Declaring a function using the function types helps Code Analysis for Drivers, Static Driver Verifier (SDV), and other verification tools find errors, and it's a requirement for writing drivers for the Windows operating system.For example, to define a MiniportDirectOidRequest function that is named "MyDirectOidRequest", use the MINIPORT_DIRECT_OID_REQUEST type as shown in this code example:
MINIPORT_DIRECT_OID_REQUEST MyDirectOidRequest;
Then, implement your function as follows:
_Use_decl_annotations_
NDIS_STATUS
MyDirectOidRequest(
NDIS_HANDLE MiniportAdapterContext,
PNDIS_OID_REQUEST OidRequest
)
{...}
The MINIPORT_DIRECT_OID_REQUEST function type is defined in the Ndis.h header file. To more accurately identify errors when you run the code analysis tools, be sure to add the Use_decl_annotations annotation to your function definition. The Use_decl_annotations annotation ensures that the annotations that are applied to the MINIPORT_DIRECT_OID_REQUEST function type in the header file are used. For more information about the requirements for function declarations, see Declaring Functions by Using Function Role Types for NDIS Drivers.
For information about Use_decl_annotations, see Annotating Function Behavior.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Supported in NDIS 6.1 and later. |
Target Platform | Windows |
Header | ndis.h (include Ndis.h) |
IRQL | <= DISPATCH_LEVEL |