ReactOS 0.4.17-dev-1343-g8fe3cee
miniport.c File Reference
#include "precomp.h"
#include <debug.h>
Include dependency graph for miniport.c:

Go to the source code of this file.

Macros

#define NDEBUG
 

Functions

static NTSTATUS InitializeConfiguration (_In_ PPORT_CONFIGURATION_INFORMATION PortConfig, _In_ PHW_INITIALIZATION_DATA InitData, _In_ ULONG BusNumber, _In_ ULONG SlotNumber)
 
static VOID AssignResourcesToConfiguration (_In_ PPORT_CONFIGURATION_INFORMATION PortConfiguration, _In_ PCM_RESOURCE_LIST ResourceList, _In_ ULONG NumberOfAccessRanges)
 
NTSTATUS MiniportInitialize (_In_ PMINIPORT Miniport, _In_ PFDO_DEVICE_EXTENSION DeviceExtension, _In_ PHW_INITIALIZATION_DATA InitData)
 
NTSTATUS MiniportFindAdapter (_In_ PMINIPORT Miniport)
 
NTSTATUS MiniportHwInitialize (_In_ PMINIPORT Miniport)
 
VOID NTAPI MiniportFreeAdapterResources (_In_ PMINIPORT Miniport)
 Tells the miniport the adapter is going away.
 
BOOLEAN MiniportHwInterrupt (_In_ PMINIPORT Miniport)
 
VOID NTAPI MiniportQueryAdapterControl (_In_ PMINIPORT Miniport)
 Asks the miniport which adapter control requests it handles.
 
SCSI_ADAPTER_CONTROL_STATUS NTAPI MiniportAdapterControl (_In_ PMINIPORT Miniport, _In_ SCSI_ADAPTER_CONTROL_TYPE ControlType, _In_opt_ PVOID Parameters)
 Sends one adapter control request, if the miniport claimed it.
 
VOID NTAPI MiniportQueryUnitControl (_In_ PMINIPORT Miniport)
 Asks the miniport which unit control requests it handles.
 
SCSI_UNIT_CONTROL_STATUS NTAPI MiniportUnitControl (_In_ PMINIPORT Miniport, _In_ SCSI_UNIT_CONTROL_TYPE ControlType, _In_opt_ PVOID Parameters)
 Sends one unit control request, if the miniport claimed it.
 
BOOLEAN NTAPI MiniportHwMSInterrupt (_In_ PMINIPORT Miniport, _In_ ULONG MessageId)
 
BOOLEAN MiniportStartIo (_In_ PMINIPORT Miniport, _In_ PSCSI_REQUEST_BLOCK Srb)
 

Macro Definition Documentation

◆ NDEBUG

#define NDEBUG

Definition at line 12 of file miniport.c.

Function Documentation

◆ AssignResourcesToConfiguration()

static VOID AssignResourcesToConfiguration ( _In_ PPORT_CONFIGURATION_INFORMATION  PortConfiguration,
_In_ PCM_RESOURCE_LIST  ResourceList,
_In_ ULONG  NumberOfAccessRanges 
)
static

Definition at line 113 of file miniport.c.

117{
118 PCM_FULL_RESOURCE_DESCRIPTOR FullDescriptor;
119 PCM_PARTIAL_RESOURCE_DESCRIPTOR PartialDescriptor;
120 PCM_PARTIAL_RESOURCE_LIST PartialResourceList;
121 PACCESS_RANGE AccessRange;
122 INT i, j;
123 ULONG RangeNumber = 0, Interrupt = 0, Dma = 0;
124
125 DPRINT1("AssignResourceToConfiguration(%p %p %lu)\n",
126 PortConfiguration, ResourceList, NumberOfAccessRanges);
127
128 /* A virtual miniport sits on a bus that hands out no resources at all */
129 if (ResourceList == NULL)
130 return;
131
132 FullDescriptor = &ResourceList->List[0];
133 for (i = 0; i < ResourceList->Count; i++)
134 {
135 PartialResourceList = &FullDescriptor->PartialResourceList;
136
137 for (j = 0; j < PartialResourceList->Count; j++)
138 {
139 PartialDescriptor = &PartialResourceList->PartialDescriptors[j];
140
141 switch (PartialDescriptor->Type)
142 {
144 DPRINT1("Port: 0x%I64x (0x%lx)\n",
145 PartialDescriptor->u.Port.Start.QuadPart,
146 PartialDescriptor->u.Port.Length);
147 if (RangeNumber < NumberOfAccessRanges)
148 {
149 AccessRange = &((*(PortConfiguration->AccessRanges))[RangeNumber]);
150 AccessRange->RangeStart = PartialDescriptor->u.Port.Start;
151 AccessRange->RangeLength = PartialDescriptor->u.Port.Length;
152 AccessRange->RangeInMemory = FALSE;
153 RangeNumber++;
154 }
155 break;
156
158 DPRINT1("Memory: 0x%I64x (0x%lx)\n",
159 PartialDescriptor->u.Memory.Start.QuadPart,
160 PartialDescriptor->u.Memory.Length);
161 if (RangeNumber < NumberOfAccessRanges)
162 {
163 AccessRange = &((*(PortConfiguration->AccessRanges))[RangeNumber]);
164 AccessRange->RangeStart = PartialDescriptor->u.Memory.Start;
165 AccessRange->RangeLength = PartialDescriptor->u.Memory.Length;
166 AccessRange->RangeInMemory = TRUE;
167 RangeNumber++;
168 }
169 break;
170
172 {
174 ULONG Level;
176
177 /* A message interrupt is always edge triggered and has no line */
178 if (TEST_FLAG(PartialDescriptor->Flags, CM_RESOURCE_INTERRUPT_MESSAGE))
179 {
180 Mode = Latched;
181 Level = 0;
182 Vector = PartialDescriptor->u.MessageInterrupt.Raw.Vector;
183
184 DPRINT1("Message interrupt: %u messages Vector %lu\n",
185 PartialDescriptor->u.MessageInterrupt.Raw.MessageCount,
186 Vector);
187 }
188 else
189 {
190 if (TEST_FLAG(PartialDescriptor->Flags, CM_RESOURCE_INTERRUPT_LATCHED))
191 Mode = Latched;
192 else
194
195 Level = PartialDescriptor->u.Interrupt.Level;
196 Vector = PartialDescriptor->u.Interrupt.Vector;
197
198 DPRINT1("Interrupt: Level %lu Vector %lu\n", Level, Vector);
199 }
200
201 if (Interrupt == 0)
202 {
203 PortConfiguration->BusInterruptLevel = Level;
204 PortConfiguration->BusInterruptVector = Vector;
205 PortConfiguration->InterruptMode = Mode;
206 }
207 else if (Interrupt == 1)
208 {
209 PortConfiguration->BusInterruptLevel2 = Level;
210 PortConfiguration->BusInterruptVector2 = Vector;
211 PortConfiguration->InterruptMode2 = Mode;
212 }
213 Interrupt++;
214 break;
215 }
216
218 DPRINT1("Dma: Channel: %lu Port: %lu\n",
219 PartialDescriptor->u.Dma.Channel,
220 PartialDescriptor->u.Dma.Port);
221 if (Dma == 0)
222 {
223 PortConfiguration->DmaChannel = PartialDescriptor->u.Dma.Channel;
224 PortConfiguration->DmaPort = PartialDescriptor->u.Dma.Port;
225
226 if (PartialDescriptor->Flags & CM_RESOURCE_DMA_8)
227 PortConfiguration->DmaWidth = Width8Bits;
228 else if ((PartialDescriptor->Flags & CM_RESOURCE_DMA_16) ||
229 (PartialDescriptor->Flags & CM_RESOURCE_DMA_8_AND_16))
230 PortConfiguration->DmaWidth = Width16Bits;
231 else if (PartialDescriptor->Flags & CM_RESOURCE_DMA_32)
232 PortConfiguration->DmaWidth = Width32Bits;
233 }
234 else if (Dma == 1)
235 {
236 PortConfiguration->DmaChannel2 = PartialDescriptor->u.Dma.Channel;
237 PortConfiguration->DmaPort2 = PartialDescriptor->u.Dma.Port;
238
239 if (PartialDescriptor->Flags & CM_RESOURCE_DMA_8)
240 PortConfiguration->DmaWidth2 = Width8Bits;
241 else if ((PartialDescriptor->Flags & CM_RESOURCE_DMA_16) ||
242 (PartialDescriptor->Flags & CM_RESOURCE_DMA_8_AND_16))
243 PortConfiguration->DmaWidth2 = Width16Bits;
244 else if (PartialDescriptor->Flags & CM_RESOURCE_DMA_32)
245 PortConfiguration->DmaWidth2 = Width32Bits;
246 }
247 Dma++;
248 break;
249
250 default:
251 DPRINT1("Other: %u\n", PartialDescriptor->Type);
252 break;
253 }
254 }
255
256 /* Advance to next CM_FULL_RESOURCE_DESCRIPTOR block in memory. */
257 FullDescriptor = (PCM_FULL_RESOURCE_DESCRIPTOR)(FullDescriptor->PartialResourceList.PartialDescriptors +
258 FullDescriptor->PartialResourceList.Count);
259 }
260}
#define DPRINT1
Definition: precomp.h:8
#define TEST_FLAG(Flags, Bit)
Definition: cdrom.h:1495
_In_ ULONG _In_ UCHAR Level
Definition: dispmprt.h:1329
#define NULL
Definition: types.h:112
#define TRUE
Definition: types.h:120
#define FALSE
Definition: types.h:117
GLsizei GLenum const GLvoid GLsizei GLenum GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLint GLint GLint GLshort GLshort GLshort GLubyte GLubyte GLubyte GLuint GLuint GLuint GLushort GLushort GLushort GLbyte GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLfloat GLint GLint GLint GLint GLshort GLshort GLshort GLshort GLubyte GLubyte GLubyte GLubyte GLuint GLuint GLuint GLuint GLushort GLushort GLushort GLushort GLboolean const GLdouble const GLfloat const GLint const GLshort const GLbyte const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLdouble const GLfloat const GLfloat const GLint const GLint const GLshort const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort GLenum GLenum GLenum GLfloat GLenum GLint GLenum GLenum GLenum GLfloat GLenum GLenum GLint GLenum GLfloat GLenum GLint GLint GLushort GLenum GLenum GLfloat GLenum GLenum GLint GLfloat const GLubyte GLenum GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLint GLint GLsizei GLsizei GLint GLenum GLenum const GLvoid GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLenum const GLdouble GLenum GLenum const GLfloat GLenum GLenum const GLint GLsizei GLuint GLfloat GLuint GLbitfield GLfloat GLint GLuint GLboolean GLenum GLfloat GLenum GLbitfield GLenum GLfloat GLfloat GLint GLint const GLfloat GLenum GLfloat GLfloat GLint GLint GLfloat GLfloat GLint GLint const GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat const GLdouble const GLfloat const GLdouble const GLfloat GLint i
Definition: glfuncs.h:248
GLsizei GLenum const GLvoid GLsizei GLenum GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLint GLint GLint GLshort GLshort GLshort GLubyte GLubyte GLubyte GLuint GLuint GLuint GLushort GLushort GLushort GLbyte GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLfloat GLint GLint GLint GLint GLshort GLshort GLshort GLshort GLubyte GLubyte GLubyte GLubyte GLuint GLuint GLuint GLuint GLushort GLushort GLushort GLushort GLboolean const GLdouble const GLfloat const GLint const GLshort const GLbyte const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLdouble const GLfloat const GLfloat const GLint const GLint const GLshort const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort GLenum GLenum GLenum GLfloat GLenum GLint GLenum GLenum GLenum GLfloat GLenum GLenum GLint GLenum GLfloat GLenum GLint GLint GLushort GLenum GLenum GLfloat GLenum GLenum GLint GLfloat const GLubyte GLenum GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLint GLint GLsizei GLsizei GLint GLenum GLenum const GLvoid GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLenum const GLdouble GLenum GLenum const GLfloat GLenum GLenum const GLint GLsizei GLuint GLfloat GLuint GLbitfield GLfloat GLint GLuint GLboolean GLenum GLfloat GLenum GLbitfield GLenum GLfloat GLfloat GLint GLint const GLfloat GLenum GLfloat GLfloat GLint GLint GLfloat GLfloat GLint GLint const GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat const GLdouble const GLfloat const GLdouble const GLfloat GLint GLint GLint j
Definition: glfuncs.h:250
_In_ ULONG Mode
Definition: hubbusif.h:303
#define CM_RESOURCE_DMA_8_AND_16
Definition: cmtypes.h:148
#define CM_RESOURCE_DMA_8
Definition: cmtypes.h:145
#define CM_RESOURCE_DMA_32
Definition: cmtypes.h:147
#define CM_RESOURCE_DMA_16
Definition: cmtypes.h:146
#define CM_RESOURCE_INTERRUPT_MESSAGE
Definition: restypes.h:118
struct _CM_FULL_RESOURCE_DESCRIPTOR * PCM_FULL_RESOURCE_DESCRIPTOR
#define CmResourceTypeMemory
Definition: restypes.h:106
#define CmResourceTypeDma
Definition: restypes.h:107
#define CmResourceTypePort
Definition: restypes.h:104
#define CM_RESOURCE_INTERRUPT_LATCHED
Definition: restypes.h:117
#define CmResourceTypeInterrupt
Definition: restypes.h:105
@ Latched
Definition: miniport.h:81
@ LevelSensitive
Definition: miniport.h:80
@ Width16Bits
Definition: miniport.h:106
@ Width8Bits
Definition: miniport.h:105
@ Width32Bits
Definition: miniport.h:107
enum _KINTERRUPT_MODE KINTERRUPT_MODE
ULONG RangeLength
Definition: srb.h:42
BOOLEAN RangeInMemory
Definition: srb.h:43
SCSI_PHYSICAL_ADDRESS RangeStart
Definition: srb.h:41
CM_PARTIAL_RESOURCE_LIST PartialResourceList
Definition: restypes.h:145
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494::@498 MessageInterrupt
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494::@496 Port
union _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494 u
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494::@500 Dma
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494::@497 Interrupt
struct _CM_PARTIAL_RESOURCE_DESCRIPTOR::@494::@499 Memory
CM_PARTIAL_RESOURCE_DESCRIPTOR PartialDescriptors[1]
Definition: restypes.h:100
int32_t INT
Definition: typedefs.h:58
uint32_t ULONG
Definition: typedefs.h:59
_Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_INTERRUPT_CONFIG _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_ WDFINTERRUPT * Interrupt
Definition: wdfinterrupt.h:379
_Must_inspect_result_ _In_ WDFIORESREQLIST _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_ WDFIORESLIST * ResourceList
Definition: wdfresource.h:309

Referenced by MiniportInitialize().

◆ InitializeConfiguration()

static NTSTATUS InitializeConfiguration ( _In_ PPORT_CONFIGURATION_INFORMATION  PortConfig,
_In_ PHW_INITIALIZATION_DATA  InitData,
_In_ ULONG  BusNumber,
_In_ ULONG  SlotNumber 
)
static

Definition at line 20 of file miniport.c.

25{
27 ULONG i;
28
29 DPRINT1("InitializeConfiguration(%p %p %lu %lu)\n",
30 PortConfig, InitData, BusNumber, SlotNumber);
31
32 /* Get the configurration information */
33 ConfigInfo = IoGetConfigurationInformation();
34
35 /* Initialize the port configuration */
36 RtlZeroMemory(PortConfig,
38
39 PortConfig->Length = sizeof(PORT_CONFIGURATION_INFORMATION);
40 PortConfig->SystemIoBusNumber = BusNumber;
41 PortConfig->SlotNumber = SlotNumber;
42 PortConfig->AdapterInterfaceType = InitData->AdapterInterfaceType;
43
44 PortConfig->MaximumTransferLength = SP_UNINITIALIZED_VALUE;
45 PortConfig->DmaChannel = SP_UNINITIALIZED_VALUE;
46 PortConfig->DmaPort = SP_UNINITIALIZED_VALUE;
47
48 PortConfig->InterruptMode = LevelSensitive;
49
50 PortConfig->Master = TRUE;
51 PortConfig->AtdiskPrimaryClaimed = ConfigInfo->AtDiskPrimaryAddressClaimed;
52 PortConfig->AtdiskSecondaryClaimed = ConfigInfo->AtDiskSecondaryAddressClaimed;
53 PortConfig->Dma32BitAddresses = TRUE;
54 PortConfig->DemandMode = FALSE;
55 PortConfig->MapBuffers = InitData->MapBuffers;
56
57 PortConfig->NeedPhysicalAddresses = TRUE;
58 PortConfig->TaggedQueuing = TRUE;
59 PortConfig->AutoRequestSense = TRUE;
60 PortConfig->MultipleRequestPerLu = TRUE;
61 PortConfig->ReceiveEvent = InitData->ReceiveEvent;
62 PortConfig->RealModeInitialized = FALSE;
63 PortConfig->BufferAccessScsiPortControlled = TRUE;
64 PortConfig->MaximumNumberOfTargets = SCSI_MAXIMUM_TARGETS_PER_BUS;
65
66 PortConfig->SpecificLuExtensionSize = InitData->SpecificLuExtensionSize;
67 PortConfig->SrbExtensionSize = InitData->SrbExtensionSize;
68 PortConfig->MaximumNumberOfLogicalUnits = SCSI_MAXIMUM_LOGICAL_UNITS;
69 PortConfig->WmiDataProvider = TRUE;
70
71 PortConfig->NumberOfAccessRanges = InitData->NumberOfAccessRanges;
72 DPRINT1("NumberOfAccessRanges: %lu\n", PortConfig->NumberOfAccessRanges);
73 if (PortConfig->NumberOfAccessRanges != 0)
74 {
75 PortConfig->AccessRanges = ExAllocatePoolWithTag(NonPagedPool,
76 PortConfig->NumberOfAccessRanges * sizeof(ACCESS_RANGE),
78 if (PortConfig->AccessRanges == NULL)
79 return STATUS_NO_MEMORY;
80
81 RtlZeroMemory(PortConfig->AccessRanges,
82 PortConfig->NumberOfAccessRanges * sizeof(ACCESS_RANGE));
83 }
84
85 for (i = 0; i < RTL_NUMBER_OF(PortConfig->InitiatorBusId); i++)
86 {
87 PortConfig->InitiatorBusId[i] = (CCHAR)SP_UNINITIALIZED_VALUE;
88 }
89
90 /* Default per-adapter outstanding IO limit, as per storport documentation. */
91 PortConfig->MaxNumberOfIO = 1000;
92
93 /* Only a Win8 or later init data block carries the request format flags */
94 PortConfig->SrbType = SRB_TYPE_SCSI_REQUEST_BLOCK;
95 if (InitData->HwInitializationDataSize >=
97 TEST_FLAG(InitData->SrbTypeFlags, SRB_TYPE_FLAG_STORAGE_REQUEST_BLOCK))
98 {
99 PortConfig->SrbType = SRB_TYPE_STORAGE_REQUEST_BLOCK;
100 }
101
102 /* Bus, target and LUN is the only addressing we hand out */
103 PortConfig->AddressType = STORAGE_ADDRESS_TYPE_BTL8;
104
105 DPRINT1("SrbType: %u\n", PortConfig->SrbType);
106
107 return STATUS_SUCCESS;
108}
#define RTL_NUMBER_OF(x)
Definition: RtlRegistry.c:12
#define STATUS_NO_MEMORY
Definition: d3dkmdt.h:51
#define SCSI_MAXIMUM_TARGETS_PER_BUS
Definition: srb.h:22
#define SCSI_MAXIMUM_LOGICAL_UNITS
Definition: srb.h:21
struct _PORT_CONFIGURATION_INFORMATION PORT_CONFIGURATION_INFORMATION
#define SP_UNINITIALIZED_VALUE
Definition: srb.h:232
#define TAG_ACCRESS_RANGE
Definition: precomp.h:34
#define ExAllocatePoolWithTag(hernya, size, tag)
Definition: env_spec_w32.h:350
#define NonPagedPool
Definition: env_spec_w32.h:307
PCONFIGURATION_INFORMATION NTAPI IoGetConfigurationInformation(VOID)
Returns a pointer to the I/O manager's global configuration information structure.
Definition: iorsrce.c:998
#define RTL_SIZEOF_THROUGH_FIELD(type, field)
Definition: ntbasedef.h:684
_In_ ULONG BusNumber
Definition: pciidex.h:65
#define SRB_TYPE_STORAGE_REQUEST_BLOCK
Definition: srb.h:664
#define STORAGE_ADDRESS_TYPE_BTL8
Definition: srb.h:666
#define SRB_TYPE_SCSI_REQUEST_BLOCK
Definition: srb.h:663
#define STATUS_SUCCESS
Definition: shellext.h:65
#define SRB_TYPE_FLAG_STORAGE_REQUEST_BLOCK
Definition: storport.h:2274
BOOLEAN AtDiskPrimaryAddressClaimed
Definition: iotypes.h:4498
BOOLEAN AtDiskSecondaryAddressClaimed
Definition: iotypes.h:4499
#define RtlZeroMemory(Destination, Length)
Definition: typedefs.h:262
char CCHAR
Definition: typedefs.h:51
_In_ WDFIORESREQLIST _In_ ULONG SlotNumber
Definition: wdfresource.h:68

Referenced by MiniportInitialize().

◆ MiniportAdapterControl()

SCSI_ADAPTER_CONTROL_STATUS NTAPI MiniportAdapterControl ( _In_ PMINIPORT  Miniport,
_In_ SCSI_ADAPTER_CONTROL_TYPE  ControlType,
_In_opt_ PVOID  Parameters 
)

Sends one adapter control request, if the miniport claimed it.

Definition at line 504 of file miniport.c.

508{
509 DPRINT("MiniportAdapterControl(%p %u %p)\n",
510 Miniport, ControlType, Parameters);
511
512 ASSERT(ControlType < ScsiAdapterControlMax);
513 if (!(Miniport->AdapterControlSupportedBitmap & (1 << ControlType)))
514 {
516 }
517
518 return Miniport->InitData->HwAdapterControl(&Miniport->MiniportExtension->HwDeviceExtension,
519 ControlType,
520 Parameters);
521}
_In_ HANDLE _In_ CONST PDXGKMDT_OPM_GET_INFO_PARAMETERS Parameters
Definition: dispmprt.h:321
@ ScsiAdapterControlMax
Definition: srb.h:182
@ ScsiAdapterControlUnsuccessful
Definition: srb.h:192
#define ASSERT(a)
Definition: mode.c:44
#define DPRINT
Definition: sndvol32.h:73

Referenced by PortFdoStopAdapter().

◆ MiniportFindAdapter()

NTSTATUS MiniportFindAdapter ( _In_ PMINIPORT  Miniport)

Definition at line 325 of file miniport.c.

327{
328 PFDO_DEVICE_EXTENSION DeviceExtension = Miniport->DeviceExtension;
332
333 DPRINT1("MiniportFindAdapter(%p)\n", Miniport);
334
335 /* HwFindAdapter is typeless since Win8, a virtual miniport puts a PVIRTUAL_HW_FIND_ADAPTER there */
336 if (Miniport->IsVirtual)
337 {
338 PVIRTUAL_HW_FIND_ADAPTER FindAdapter;
339
340 FindAdapter = (PVIRTUAL_HW_FIND_ADAPTER)Miniport->InitData->HwFindAdapter;
341
342 Result = FindAdapter(&Miniport->MiniportExtension->HwDeviceExtension,
343 DeviceExtension->PhysicalDevice,
344 DeviceExtension->Device,
345 DeviceExtension->LowerDevice,
346 NULL,
347 &Miniport->PortConfig,
348 &Reserved);
349 }
350 else
351 {
352 PHW_FIND_ADAPTER FindAdapter;
353
354 FindAdapter = (PHW_FIND_ADAPTER)Miniport->InitData->HwFindAdapter;
355
356 Result = FindAdapter(&Miniport->MiniportExtension->HwDeviceExtension,
357 NULL,
358 NULL,
359 NULL,
360 &Miniport->PortConfig,
361 &Reserved);
362 }
363 DPRINT1("HwFindAdapter() returned %lu\n", Result);
364
365 /* Convert the result to a status code */
366 switch (Result)
367 {
369 DPRINT1("SP_RETURN_NOT_FOUND\n");
371 break;
372
373 case SP_RETURN_FOUND:
374 DPRINT1("SP_RETURN_FOUND\n");
376 break;
377
378 case SP_RETURN_ERROR:
379 DPRINT1("SP_RETURN_ERROR\n");
381 break;
382
384 DPRINT1("SP_RETURN_BAD_CONFIG\n");
386 break;
387
388 default:
389 DPRINT1("Unknown result: %lu\n", Result);
391 break;
392 }
393
394 return Status;
395}
unsigned char BOOLEAN
Definition: actypes.h:127
LONG NTSTATUS
Definition: precomp.h:26
#define SP_RETURN_ERROR
Definition: srb.h:523
#define SP_RETURN_FOUND
Definition: srb.h:522
#define SP_RETURN_BAD_CONFIG
Definition: srb.h:524
#define SP_RETURN_NOT_FOUND
Definition: srb.h:521
ULONG(NTAPI * PHW_FIND_ADAPTER)(IN PVOID DeviceExtension, IN PVOID HwContext, IN PVOID BusInformation, IN PCHAR ArgumentString, IN OUT PPORT_CONFIGURATION_INFORMATION ConfigInfo, OUT PBOOLEAN Again)
Definition: srb.h:468
Status
Definition: gdiplustypes.h:24
#define STATUS_INTERNAL_ERROR
Definition: ntstatus.h:559
#define STATUS_DEVICE_CONFIGURATION_ERROR
Definition: ntstatus.h:713
#define STATUS_ADAPTER_HARDWARE_ERROR
Definition: ntstatus.h:524
#define STATUS_NOT_FOUND
Definition: shellext.h:72
ULONG(NTAPI * PVIRTUAL_HW_FIND_ADAPTER)(_In_ PVOID DeviceExtension, _In_ PVOID HwContext, _In_ PVOID BusInformation, _In_ PVOID LowerDevice, _In_ PCHAR ArgumentString, _Inout_ PPORT_CONFIGURATION_INFORMATION ConfigInfo, _In_ PBOOLEAN Again)
Definition: storport.h:7123
PDEVICE_OBJECT LowerDevice
Definition: i8042prt.h:130
PDEVICE_OBJECT PhysicalDevice
Definition: precomp.h:248
PDEVICE_OBJECT Device
Definition: precomp.h:246
_Reserved_ PVOID Reserved
Definition: winddi.h:3974
_At_(*)(_In_ PWSK_CLIENT Client, _In_opt_ PUNICODE_STRING NodeName, _In_opt_ PUNICODE_STRING ServiceName, _In_opt_ ULONG NameSpace, _In_opt_ GUID *Provider, _In_opt_ PADDRINFOEXW Hints, _Outptr_ PADDRINFOEXW *Result, _In_opt_ PEPROCESS OwningProcess, _In_opt_ PETHREAD OwningThread, _Inout_ PIRP Irp Result)(Mem)) NTSTATUS(WSKAPI *PFN_WSK_GET_ADDRESS_INFO
Definition: wsk.h:409

Referenced by PortFdoStartMiniport().

◆ MiniportFreeAdapterResources()

VOID NTAPI MiniportFreeAdapterResources ( _In_ PMINIPORT  Miniport)

Tells the miniport the adapter is going away.

Definition at line 419 of file miniport.c.

421{
422 if (Miniport->MiniportExtension == NULL ||
423 Miniport->InitData->HwInitializationDataSize != sizeof(*Miniport->InitData) ||
424 Miniport->InitData->HwFreeAdapterResources == NULL)
425 {
426 return;
427 }
428
429 DPRINT1("MiniportFreeAdapterResources(%p)\n", Miniport);
430
431 Miniport->InitData->HwFreeAdapterResources(&Miniport->MiniportExtension->HwDeviceExtension);
432}

Referenced by PortFdoPnp().

◆ MiniportHwInitialize()

NTSTATUS MiniportHwInitialize ( _In_ PMINIPORT  Miniport)

Definition at line 399 of file miniport.c.

401{
403
404 DPRINT("MiniportHwInitialize(%p)\n", Miniport);
405
406 /* Call the miniport HwInitialize routine */
407 Result = Miniport->InitData->HwInitialize(&Miniport->MiniportExtension->HwDeviceExtension);
408 DPRINT("HwInitialize() returned %u\n", Result);
409
411}
#define STATUS_UNSUCCESSFUL
Definition: udferr_usr.h:132

Referenced by PortFdoStartMiniport().

◆ MiniportHwInterrupt()

BOOLEAN MiniportHwInterrupt ( _In_ PMINIPORT  Miniport)

Definition at line 436 of file miniport.c.

438{
440
441 DPRINT("MiniportHwInterrupt(%p)\n",
442 Miniport);
443
444 Result = Miniport->InitData->HwInterrupt(&Miniport->MiniportExtension->HwDeviceExtension);
445 DPRINT("HwInterrupt() returned %u\n", Result);
446
447 return Result;
448}

Referenced by PortFdoInterruptRoutine().

◆ MiniportHwMSInterrupt()

BOOLEAN NTAPI MiniportHwMSInterrupt ( _In_ PMINIPORT  Miniport,
_In_ ULONG  MessageId 
)

Definition at line 603 of file miniport.c.

606{
608
609 DPRINT("MiniportHwMSInterrupt(%p %lu)\n",
610 Miniport, MessageId);
611
612 Result = Miniport->PortConfig.HwMSInterruptRoutine(&Miniport->MiniportExtension->HwDeviceExtension,
613 MessageId);
614 DPRINT("HwMSInterruptRoutine() returned %u\n", Result);
615
616 return Result;
617}
_In_ ULONG MessageId
Definition: hubioctl.cpp:1369

Referenced by PortFdoMessageInterruptRoutine().

◆ MiniportInitialize()

NTSTATUS MiniportInitialize ( _In_ PMINIPORT  Miniport,
_In_ PFDO_DEVICE_EXTENSION  DeviceExtension,
_In_ PHW_INITIALIZATION_DATA  InitData 
)

Definition at line 264 of file miniport.c.

268{
269 PMINIPORT_DEVICE_EXTENSION MiniportExtension;
270 ULONG Size;
272
273 DPRINT1("MiniportInitialize(%p %p %p)\n",
274 Miniport, DeviceExtension, InitData);
275
276 Miniport->DeviceExtension = DeviceExtension;
277 Miniport->InitData = InitData;
278
279 /* Win7 virtual miniports used a shorter structure, Win8 ones set a feature flag */
280 Miniport->IsVirtual = (InitData->HwInitializationDataSize == HW_INIT_DATA_SIZE_VIRTUAL_LEGACY) ||
281 ((InitData->HwInitializationDataSize == sizeof(*InitData)) &&
282 (InitData->FeatureSupport & STOR_FEATURE_VIRTUAL_MINIPORT));
283 DPRINT1("Miniport is %s\n", Miniport->IsVirtual ? "virtual" : "physical");
284
285 /* Calculate the miniport device extension size */
286 Status = RtlULongAdd(sizeof(*MiniportExtension),
287 Miniport->InitData->DeviceExtensionSize,
288 &Size);
289 if (!NT_SUCCESS(Status))
290 {
291 DPRINT1("Invalid miniport extension size %lx\n", Miniport->InitData->DeviceExtensionSize);
292 return Status;
293 }
294
295 /* Allocate and initialize the miniport device extension */
296 MiniportExtension = ExAllocatePoolWithTag(NonPagedPool,
297 Size,
299 if (MiniportExtension == NULL)
300 return STATUS_NO_MEMORY;
301
302 RtlZeroMemory(MiniportExtension, Size);
303
304 MiniportExtension->Miniport = Miniport;
305 Miniport->MiniportExtension = MiniportExtension;
306
307 /* Initialize the port configuration */
308 Status = InitializeConfiguration(&Miniport->PortConfig,
309 InitData,
310 DeviceExtension->BusNumber,
311 DeviceExtension->SlotNumber);
312 if (!NT_SUCCESS(Status))
313 return Status;
314
315 /* Assign the resources to the port configuration */
316 AssignResourcesToConfiguration(&Miniport->PortConfig,
317 DeviceExtension->AllocatedResources,
318 InitData->NumberOfAccessRanges);
319
320 return STATUS_SUCCESS;
321}
#define NT_SUCCESS(StatCode)
Definition: apphelp.c:33
#define TAG_MINIPORT_DATA
Definition: precomp.h:33
#define HW_INIT_DATA_SIZE_VIRTUAL_LEGACY
Definition: precomp.h:75
static VOID AssignResourcesToConfiguration(_In_ PPORT_CONFIGURATION_INFORMATION PortConfiguration, _In_ PCM_RESOURCE_LIST ResourceList, _In_ ULONG NumberOfAccessRanges)
Definition: miniport.c:113
static NTSTATUS InitializeConfiguration(_In_ PPORT_CONFIGURATION_INFORMATION PortConfig, _In_ PHW_INITIALIZATION_DATA InitData, _In_ ULONG BusNumber, _In_ ULONG SlotNumber)
Definition: miniport.c:20
#define STOR_FEATURE_VIRTUAL_MINIPORT
Definition: storport.h:2280
struct _MINIPORT * Miniport
Definition: precomp.h:91
_Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_DEVICE_PROPERTY_DATA _In_ DEVPROPTYPE _In_ ULONG Size
Definition: wdfdevice.h:4539

◆ MiniportQueryAdapterControl()

VOID NTAPI MiniportQueryAdapterControl ( _In_ PMINIPORT  Miniport)

Asks the miniport which adapter control requests it handles.

Definition at line 456 of file miniport.c.

458{
462 ULONG Type;
463
464 Miniport->AdapterControlSupportedBitmap = 0;
465
466 if (Miniport->InitData->HwAdapterControl == NULL)
467 return;
468
469 Length = sizeof(*List) +
470 (ScsiAdapterControlMax * sizeof(List->SupportedTypeList[0]));
471
473 if (List == NULL)
474 return;
475
476 List->MaxControlType = ScsiAdapterControlMax;
477
478 Result = Miniport->InitData->HwAdapterControl(&Miniport->MiniportExtension->HwDeviceExtension,
480 List);
482 {
483 for (Type = 0; Type < ScsiAdapterControlMax; Type++)
484 {
485 C_ASSERT(ScsiAdapterControlMax <= RTL_BITS_OF(Miniport->AdapterControlSupportedBitmap));
486
487 if (List->SupportedTypeList[Type])
488 {
489 DPRINT1("Adapter control %lu supported\n", Type);
490 Miniport->AdapterControlSupportedBitmap |= 1 << Type;
491 }
492 }
493 }
494
496}
Type
Definition: Type.h:7
@ ScsiQuerySupportedControlTypes
Definition: srb.h:177
@ ScsiAdapterControlSuccess
Definition: srb.h:191
enum _SCSI_ADAPTER_CONTROL_STATUS SCSI_ADAPTER_CONTROL_STATUS
#define C_ASSERT(e)
Definition: intsafe.h:73
#define ExFreePoolWithTag(_P, _T)
Definition: module.h:1109
static PVOID ExAllocatePoolZero(ULONG PoolType, SIZE_T NumberOfBytes, ULONG Tag)
Definition: precomp.h:45
#define RTL_BITS_OF(sizeOfArg)
Definition: ntbasedef.h:680
_In_ ULONG _In_ ULONG _In_ ULONG Length
Definition: ntddpcm.h:102
_Must_inspect_result_ _In_ WDFCMRESLIST List
Definition: wdfresource.h:550

Referenced by PortFdoStartMiniport().

◆ MiniportQueryUnitControl()

VOID NTAPI MiniportQueryUnitControl ( _In_ PMINIPORT  Miniport)

Asks the miniport which unit control requests it handles.

Definition at line 529 of file miniport.c.

531{
535 ULONG Type;
536
537 Miniport->UnitControlSupportedBitmap = 0;
538
539 if (Miniport->InitData->HwInitializationDataSize <
541 Miniport->InitData->HwUnitControl == NULL)
542 {
543 return;
544 }
545
546 Length = sizeof(*List) +
547 (ScsiUnitControlMax * sizeof(List->SupportedTypeList[0]));
548
550 if (List == NULL)
551 return;
552
553 List->MaxControlType = ScsiUnitControlMax;
554
555 Result = Miniport->InitData->HwUnitControl(&Miniport->MiniportExtension->HwDeviceExtension,
557 List);
559 {
560 for (Type = 0; Type < ScsiUnitControlMax; Type++)
561 {
562 C_ASSERT(ScsiUnitControlMax <= RTL_BITS_OF(Miniport->UnitControlSupportedBitmap));
563
564 if (List->SupportedTypeList[Type])
565 {
566 DPRINT1("Unit control %lu supported\n", Type);
567 Miniport->UnitControlSupportedBitmap |= 1 << Type;
568 }
569 }
570 }
571
573}
enum _SCSI_UNIT_CONTROL_STATUS SCSI_UNIT_CONTROL_STATUS
@ ScsiUnitControlSuccess
Definition: storport.h:1591
@ ScsiQuerySupportedUnitControlTypes
Definition: storport.h:1568
@ ScsiUnitControlMax
Definition: storport.h:1585

Referenced by PortFdoStartMiniport().

◆ MiniportStartIo()

BOOLEAN MiniportStartIo ( _In_ PMINIPORT  Miniport,
_In_ PSCSI_REQUEST_BLOCK  Srb 
)

Definition at line 621 of file miniport.c.

624{
626
627 DPRINT("MiniportHwStartIo(%p %p)\n",
628 Miniport, Srb);
629
630 Result = Miniport->InitData->HwStartIo(&Miniport->MiniportExtension->HwDeviceExtension, Srb);
631 DPRINT("HwStartIo() returned %u\n", Result);
632
633 return Result;
634}
_In_ PSCSI_REQUEST_BLOCK Srb
Definition: cdrom.h:989

◆ MiniportUnitControl()

SCSI_UNIT_CONTROL_STATUS NTAPI MiniportUnitControl ( _In_ PMINIPORT  Miniport,
_In_ SCSI_UNIT_CONTROL_TYPE  ControlType,
_In_opt_ PVOID  Parameters 
)

Sends one unit control request, if the miniport claimed it.

Definition at line 581 of file miniport.c.

585{
586 DPRINT("MiniportUnitControl(%p %u %p)\n",
587 Miniport, ControlType, Parameters);
588
589 ASSERT(ControlType < ScsiUnitControlMax);
590 if (!(Miniport->UnitControlSupportedBitmap & (1 << ControlType)))
591 {
593 }
594
595 return Miniport->InitData->HwUnitControl(&Miniport->MiniportExtension->HwDeviceExtension,
596 ControlType,
597 Parameters);
598}
@ ScsiUnitControlNotSupported
Definition: storport.h:1593

Referenced by PortCreatePdo(), and PortDeletePdo().